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 Doré 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 Doré 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)

September 02, 1992