MPE_Open_graphics - (collectively) opens an X Windows display
#include "mpe.h"
int MPE_Open_graphics( handle, comm, display, x, y, w, h, is_collective )
MPE_XGraph *handle;
MPI_Comm comm;
char display[MPI_MAX_PROCESSOR_NAME+4];
int x, y;
int w, h;
int is_collective;
- comm
- - Communicator of participating processes
- display
- - Name of X window display. If null, display will be taken
from the DISPLAY variable on the process with rank 0 in comm . If
that is either undefined, or starts with w ":", then the value
of display is `hostname`:0
- x,y
- - position of the window. If (-1,-1) , then the user
should be asked to position the window (this is a window manager
issue).
- w,h
- - width and height of the window, in pixels.
- is_collective
- - true if the graphics operations are collective; this
allows the MPE graphics operations to make fewer connections to the
display. If false, then all processes in the communicator comm will open
the display; this could exceed the number of connections that your X
window server allows. Not yet implemented.
- handle
- - Graphics handle to be given to other MPE graphics
routines.
This is a collective routine. All processes in the given communicator must call
it, and it has the same semantics as
MPI_Barrier (that is, other
collective operations can not cross this routine).
The Fortran interface to this routine is different from its C counterpart and it
has an additional argument, ierr, at the end of the argument list, i.e. the
returned function value (the error code) in C interface is returned as the
additional argument in Fortran interface. The Fortran interface is invoked
with the CALL statement.
All MPI and MPE objects, MPI_Comm, MPE_XGraph and MPE_Color, are of type INTEGER
in Fortran.
If Fortran
display argument is an empty string, "", display
will be taken from the DISPLAY variable on the process with rank 0 in
comm .
The trailing blanks in Fortran CHARACTER string argument will be ignored.
mpe_graphics.c