GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  MPE_OPEN_GRAPHICS (4)

NAME

MPE_Open_graphics - (collectively) opens an X Windows display

CONTENTS

Synopsis
Input Parameters
Output Parameter
Notes
Notes For Fortran Interface
Additional Notes For Fortran Interface
Location

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

Search for    or go to Top of page |  Section 4 |  Main Index


MPE_OPEN_GRAPHICS (4) 4/2/2012

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.