Man Linux: Main Page and Category List

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

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

       mpe_graphics.c

                                   12/6/2001              MPE_Open_graphics(4)