Name

PINCH − Sets the choice device to application-required values. 

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

Syntax

PINCH (WKID, CHDNR, ISTAT, ICHNR, PET, XMIN, XMAX, YMIN, YMAX, LDR,
DATREC)

Argument     Data Type      Access    Description
---------------------------------------------------------------------------
WKID         Integer        Read      Workstation identifier
CHDNR        Integer        Read      Choice device number
ISTAT        Integer        Read      Initial status
ICHNR        Integer        Read      Initial choice number
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
---------------------------------------------------------------------------

Constants

Defined Argument     Constant     Description
---------------------------------------------------------------------------
ISTAT                POK          Use this value if you are supplying an
                                  initial choice.
                     PNCHOI       Use this value if you are not supplying
                                  an initial choice.
---------------------------------------------------------------------------

Description

PINCH sets the choice device to application-required values.  This function accepts the initial choice status, initial choice value, and the echo area.  The initial choice status indicates whether Digital PHIGS selects a choice item by default.  The echo area is a 4-component list of x- and y-coordinates, in device coordinates.  The order of the list is XMIN < XMAX, YMIN < YMAX.  The z-components of a previously specified echo volume remain unchanged. 

When the application calls PINCH, the workstation surface cannot contain the choice device’s prompt.  To remove an existing prompt from the surface, call the PSCHM 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 Choice-Class PETs for information on choice-class prompt and echo types. 

See Also

PGTCH
PINCH3
PQCHS
PQDCH
PRQCH
PSMCH
PSCHM