To Open and Initialize for Output

Syntax Examples

C programs^[19]:

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

FORTRAN 77 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(3X11) 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. For portability across the HP graphics device family, use a NULL parameter. In this case, Starbase will automatically choose the appropriate driver.
For example:
NULL for C
char(0) for FORTRAN 77
'' for Pascal
A character string may be used to specify the driver. For example:
"hpcrx48z" for C
'hpcrx48z'//char(0) for FORTRAN 77
'hpcrx48z' for Pascal

mode - The mode control word consists of several flag bits or- ed 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 more details of gopen actions when accessing an X Window.
- 0 (zero) - Open the window, but do nothing else. The software color table is initialized from the current state of the hardware color map for that window.
- INIT - Open and initialize the device as follows:
  The window is cleared to 0s. For overlay windows, only the overlay planes are cleared. For image windows, the 48 image planes are cleared.
  The color map is reset to its default values. For depth 8 windows, the color map is initialized as CMAP_NORMAL. For depth 24 windows, the color map is initialized as CMAP_FULL.
  Clear the Z-buffer.
- RESET_DEVICE - This flag is equivalent to INIT.
- SPOOLED - Not supported.
- MODEL_XFORM - Opening in MODEL_XFORM mode will affect how matrix stack and transformation routines are performed. See gopen(3G) for more information.
- INT_XFORM - Only integer and common operations will be performed. All floating point operations will cause an error.
- INT_XFORM_32 - Only integer and common operations will be performed. All floating point operations will cause an error.
  This mode is provided for compatibility of integer precision with previous devices. INT_XFORM will 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.
- UNACCELERATED - This flag is ignored.
- ACCELERATED - This flag is ignored.

A table located in the section "HP VMX: The CRX-family Overlay Plane Driver" in the "HP VMX Device Driver" chapter in this manual lists which driver will be selected at gopen based on whether:

A window is in the image planes or overlay planes.
The window has backing store or not.
The hpcrx48z, hpvmx, or NULL driver is specified.

^[19]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 for Output

Technical documentation

» Table of Contents

» Index

Syntax Examples

Parameters for gopen