Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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  connec-
	      tions 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 counter-
       part and	it has an additional argument, ierr, at	the end	of  the	 argu-
       ment  list,  i.e. the returned function value (the error	code) in C in-
       terface 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  ig-
       nored.

LOCATION
				   4/2/2012		  MPE_Open_graphics(4)

NAME | SYNOPSIS | INPUT PARAMETERS | OUTPUT PARAMETER | NOTES | NOTES FOR FORTRAN INTERFACE | ADDITIONAL NOTES FOR FORTRAN INTERFACE | LOCATION

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=MPE_Open_graphics&sektion=4&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help