Provided by: mpi-doc_1.2.7-10ubuntu1_all bug

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)