DdSetOptions(3D)

NAME
DdSetOptions - Set driver specific values of a device

SYNOPSIS
C:
DtObject DdSetOptions(device, argstring)
DtObject device;
DtPtr argstring;

FORTRAN:
INTEGER*4 DDSO(DEVICE, ARGSTR, LARG)
INTEGER*4 DEVICE, LARG
CHARACTER*LARG ARGSTR

DESCRIPTION
DdSetOptions modifies driver specific attributes of a Dore device that has previously been created with DoDevice <DOD>. The attributes that may be changed using DdSetOptions depend on the specific device driver. For example, a driver may have an option to modify the method used to compute the transparency of a primitive object.

The parameter device is an object handle to the device previously created with DoDevice <DOD>.

The parameter argstring is a string with embedded device options. Options specify the attribute and the value to be assigned. 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.

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 device parameter.

For information on particular device, see your Dore System Guide.

FORTRAN SPECIFIC

ARGSTR is a string LARG bytes long containing device options.

ERRORS
DdSetOptions will fail if the device handle is invalid.

[WARNING - invalid device handle]

SEE ALSO
DoDevice(3D)