To Open and Initialize the Device for Output

Syntax Examples

C programs^[11]:

fildes = gopen("〈screen〉/window", OUTDEV, NULL, INIT);

FORTRAN77 programs:

  fildes = gopen('〈screen〉/window'//char(0), OUTDEV,
+               char(0), INIT)

Pascal programs:

fildes := gopen('〈screen〉/window', OUTDEV, '', INIT);

Parameters for gopen

The gopen procedure has four parameters:path, kind, driver, and mode.

path — This is the name of the device file created by xwcreate(1) or created with XCreateWindow(3X) and returned from make_X11_gopen_string(3G).
kind — This parameter should be OUTDEV if the window will be used for output, INDEV if the window will be be used for Starbase input, or OUTINDEV if the window will be used for both output and Starbase input.
driver — The character representation of the driver type. If this parameter is set to NULL, then gopen will inquire the device and use the appropriate driver. Where there are both accelerated and unaccelerated versions of the driver, the default is to load the accelerated version.
For example:
NULL for C.
char(0) for FORTRAN 77.
'' for Pascal.
Or, a character string may be used to specify a driver. For example:
"hphcrx48z" for C.
'hphcrx48z'//char(0) for FORTRAN 77.
'hphcrx48z' for Pascal.

mode — The mode control word consists of several flag bits ORed together. Listed below are flag bits that have device-dependent actions. Those flags not discussed below operate as defined by the gopen procedure. See the Starbase Graphics Techniques manual for a description of gopen actions when accessing an X11 Window.
- 0 (zero) — Open the device, but do nothing else. The software color table is initialized from the current state of the hardware color map.
- INIT — Open and initialize the device as follows:
  The frame buffer is cleared to zeros.
  The color map is reset to its default values.
  The display is enabled for reading and writing.
  The Z-buffer is cleared.
- RESET_DEVICE — Same as INIT.
- SPOOLED — Not supported; raster devices cannot be spooled.
- MODEL_XFORM — Opening in MODEL_XFORM mode will affect how matrix stack and transformation routines are performed.
- INT_XFORM — Perform only integer and common operations. All floating point operations will cause an error.
- INT_XFORM_32 — Perform only integer and common operations, with extended precision. All floating point operations will cause an error.
  This mode is provided for compatibility of integer precision with previous devices. INT_XFORM might use a faster transformation pipeline with slightly less precision. It is recommended to use INT_XFORM unless maximum precision is required. If maximum precision is required, even at the expense of performance, use INT_XFORM_32.
- FLOAT_XFORM — Perform only floating point and common operations. All integer operations will cause an error.
- UNACCELERATED — Tells the hphcrx48z driver to not use the HP Visualize-48 and HP Visualize-48XP accelerators. This flag only applies when NULL is specified for the driver name.
- ACCELERATED — Tells the hphcrx48z driver to use the HP Visualize-48 and HP Visualize-48XP accelerators (default). This flag only applies when NULL is specified for the driver name.

^[11]The actual path names of directories in angle brackets depend on the file system structure. See the Graphics Administration Guide for details.

To Open and Initialize the Device for Output

Technical documentation

» Table of Contents

» Index

Syntax Examples

Parameters for gopen