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

NAME

DoDevice − Open a device

SYNOPSIS

DtObject DoDevice(devicetype, argstring)
DtPtr devicetype;
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 string that specifies the type of device to create.

argstring is a string with embedded device options. The options specify optional 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 Titan 1500/3000 X-based Doré device. For a list of Doré-supported devices on your system, and for information regarding these devices, see the Doré System Guide for your particular system.

“rasterfile” - a simple file format for full-color pixel data output. The options are:

“-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. The options are:

“-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 of the given visual type
(where vtype is DcDirectColor, DcPseudoColor,
etc.).
“-window xwindow”
requests that the x window handle xwindow
that was opened by the application be the
window in which Doré draws. 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