Name

PINST3 − Sets the string device to application-specific values. 

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

Syntax

PINST3 (WKID, STDNR, LSTR, ISTR, PET, EVOL, LDR, DATREC)

Argument     Data Type      Access    Description
---------------------------------------------------------------------------
WKID         Integer        Read      Workstation identifier.
STDNR        Integer        Read      String device number.
LSTR         Integer        Read      Length of the initial string.  The
                                      number of characters used is the
                                      minimum of LSTR and the length of ISTR.
ISTR         Character ∗80  Read      Initial string.
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

PINST3 sets the string device to application-specific values.  This function accepts the initial (default) string and echo volume.  The echo volume is 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 PINST3, the workstation surface cannot contain the string device’s prompt. To remove an existing prompt from the surface, call the PSSTM 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 String-Class PET for information on string-class prompt and echo types. 

See Also

PGTST
PINST
PQDST3
PQSTS3
PRQST
PSMST
PSSTM