DragonFly On-Line Manual Pages

Search: Section:  

MPE_Open_graphics(4)                  MPE                 MPE_Open_graphics(4)


NAME

       MPE_Open_graphics -  (collectively) opens an X Windows display


SYNOPSIS

       #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;


INPUT PARAMETERS

       comm   - Communicator of participating processes

       display
              - Name of X window display.  If NULL, display will be taken from
              the local DISPLAY variable on each process. If the local DISPLAY
              is undefined, the DISPLAY variable of the process with rank 0 in
              'comm' will be used.  If that is either undefined then the value
              of display is ``hostname``:0, or if it starts with w ":xy", then
              the value of display is ``hostname``:xy.

       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.


OUTPUT PARAMETER

       handle - Graphics handle to be given to other MPE graphics routines.


NOTES

       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).


NOTES FOR FORTRAN INTERFACE

       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.


ADDITIONAL NOTES FOR FORTRAN INTERFACE

       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.


LOCATION


                                   4/2/2012               MPE_Open_graphics(4)

Search: Section: