Name

PINVL3 − Sets the valuator device to application-specific values. 

Operating States: PHOP, WSOP, ∗, ∗
PHIGS standard function

Old Syntax

PINVL3 (WKID, VLDNR, IVAL, PET, EVOL, LOVAL, HIVAL, LDR, DATREC)

Argument     Data Type      Access    Description
---------------------------------------------------------------------------
WKID         Integer        Read      Workstation identifier
VLDNR        Integer        Read      Valuator device number
IVAL         Real           Read      Initial value
PET          Integer        Read      Prompt and echo type
EVOL(6)      Array of       Read      Echo volume, in device coordinates
             reals                    (XMIN, XMAX, YMIN, YMAX, ZMIN, ZMAX)
LOVAL,       Real           Read      Minimum and maximum value
HIVAL
LDR          Integer        Read      Dimension of the data record array
DATREC(LDR)  Character ∗80  Read      Data record
---------------------------------------------------------------------------

New Syntax

PINVL3 (WKID, VLDNR, IVAL, PET, EVOL, LDR, DATREC)

Argument     Data Type      Access    Description
---------------------------------------------------------------------------
WKID         Integer        Read      Workstation identifier
VLDNR        Integer        Read      Valuator device numbe
IVAL         Real           Read      Initial value
PET          Integer        Read      Prompt and echo type
EVOL(6)      Array of       Read      Echo volume, in device coordinates
             reals                    (XMIN, XMAX, YMIN, YMAX, ZMIN, ZMAX)
LDR          Integer        Read      Dimension of the data record array
DATREC(LDR)  Character ∗80  Read      Data record
---------------------------------------------------------------------------

Description

PINVL sets the valuator device to application-specific values.  This function accepts the echo volume in a 6-component list of x-, y-, and z-coordinates, in device coordinates.  The order of the list components is XMIN < XMAX, YMIN < YMAX, ZMIN < ZMAX. 

When an application calls PINVL, the workstation surface cannot contain the valuator device’s prompt.  To remove an existing prompt from the surface, call the PSVLM function and place the device in request mode. 

The size and contents of the data record depend on the prompt and echo type you specify.  If the size or contents of the data record does not match the requirements of your chosen prompt and echo type, Digital PHIGS generates an error. 

See Valuator-Class PETs for information on valuator-class prompt and echo types. 

See Also

PGTVL
PINVL
PQDVL3
PQVLS3
PRQVL
PSMVL
PSVLM