DoDevice(3D) — Stardent Computer Inc. (\*(Dd)

NAME

DoDevice − Open a device

SYNOPSIS

DtObject DoDevice(devicetype, argstring)
DtPtr device_type;
DtPtr argstring;

Fortran:

INTEGER∗4 DOD(DEVTYP, LDEV, ARGSTR, LARG)
INTEGER∗4 LDEV, LARG
CHARACTER∗LDEV DEVTYP
CHARACTER∗LARG ARGSTR

DESCRIPTION

DoDevice opens and initializes a Doré device of the indicated type. A device is an output mechanism used to display a frame. DoDevice returns an object handle to be used for further references to the device.

devicetype is a null terminated string that specifies the type of device to create.

argstring is a null terminated string with embedded device options. Options specify optional permanent initialization values for the device. Options not specified will default to reasonable values. An option takes one of the following forms:

-optionflag optionvalue
for options requiring values.

-optionflag
for boolean flags where the presence of "-optionflag" means true and the absence of "-optionflag" means false.

Numeric option values must be specified by their decimal ASCII representations. Multiple options within argstring must be separated by at least one blank, tab, or comma, though all legal options may occur in any order within argstring. If the same option is specified more than once in argstring, then only the last value for that option is used. The legal options in argstring depend upon the devicetype parameter.

The following two examples list the allowable device options for two different devices. The first example lists the options for a generic raster Doré device, and the second example lists the options for a Stardent 1500/3000 X-based Doré device. For information on the devices available on your Doré configuration, see Appendix E: Doré Configurations in the Doré Reference Guide. For information on particular devices, see Appendix F: Doré Device Drivers in the Doré Reference Guide. In some cases, pertinent information may be found in the release notes accompanying the Doré implementation.

∗ “rasterfile” - a simple file format for full-color pixel data output.

“-filename name”
where name is a string that specifies the
name of the file into which the image should be
stored.
“-width pixwidth”
where pixwidth is the width in pixels of the
image to be saved. The default width is 512
pixels if this parameter is not specified.

“-height pixheight”
where pixheight is the height in pixels of
the image to be saved. The default height is
512 pixels if this parameter is not specified.
∗ “stardentx11” - a dynamic x11 window device.
“-singlebuffered”
requests a single buffered window.
“-geometry geomstring”
requests a window with a particular position
and size. The format for geomstring is “WxH+X+Y”
or “WxH” (where W, H, X, and Y are the integer
values for width, height, and the X,Y position
of the upper left corner of the window). If
the “WxH” format is used, X and Y are assumed
to be zero.
“-visualtype vtype”
requests a window with of the given visual type
(where vtype is DcDirectColor, DcPseudoColor,
etc.).
“-window xwindow”
passes to the handle of a window that was opened
by the application and into which Doré is
to draw. When this option is included, options of
the previous three types will be ignored.
“-display xdisplay”
If a window option was specified, that window on
the display xdisplay is used. Otherwise, Doré
opens a window on xdisplay.
“-stereo”
requests a stereo window.

After a call to DoDevice and until the device object is deleted, the device handle may be used by subsequent device functions to alter the characteristics of the actual device (such as causing it to display). Doré devices use right-handed 3−D floating point coordinate systems with the origin in the back, lower, left corner of the actual device.

FORTRAN SPECIFIC

DEVTYP is a string LDEV bytes long containing the type of device to create.

ARGSTR is a string LARG bytes long containing device options.

ERRORS

DoDevice will fail if the specified device is unavailable or an illegal device type or option is specified.

[SEVERE - unable to allocate device]

DoDevice will fail if enough memory for the device cannot be allocated

[SEVERE - unable to allocate memory]

Museum