Name

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

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

Syntax

PINST (WKID, STDNR, LSTR, ISTR, PET, XMIN, XMAX, YMIN, YMAX,
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.
XMIN, XMAX,  Real           Read      Echo area, in device coordinates.
YMIN, YMAX
LDR          Integer        Read      Dimension of the data record array.
DATREC(LDR)  Character ∗80  Read      Data record.
---------------------------------------------------------------------------

Description

PINST sets the string device to application-specific values.  The function accepts the initial (default) string and echo area.  The echo area is a 4-component list of x- and y-coordinates, in device coordinates. The order of the list components is XMIN < XMAX, YMIN < YMAX.  The z-components of a previously specified echo volume remain unchanged. 

When an application calls PINST, 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
PINST3
PQDST
PQSTS
PRQST
PSMST
PSSTM