Name

PINPK3 − Sets the pick device to application-specific values. 

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

Syntax

PINPK3 (WKID, PKDNR, ISTAT, IPPD, PP, PET, EVOL, LDR, DATREC, PPORDR)

Argument     Data Type      Access    Description
---------------------------------------------------------------------------
WKID         Integer        Read      Workstation identifier
PKDNR        Integer        Read      Pick device number
ISTAT        Integer        Read      Initial status
IPPD         Integer        Read      Depth of the initial pick device
PP(3, IPPD)  Array of       Read      Pick path (struct_id1, pick_id1,
             integers                 element_number1,...struct_idIPPD,
                                      pick_idIPPD, element_numberIPPD)
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
PPORDR       Integer        Read      Pick path order
---------------------------------------------------------------------------

Constants

Defined Argument     Constant     Description
---------------------------------------------------------------------------
ISTAT                POK          Use this value if you are supplying an
                                  initial pick.
                     PNCHOI       Use this value if you are not supplying
                                  an initial pick.
PPORDR               PPOTOP       Top first.
                     PPOBOT       Bottom first.
---------------------------------------------------------------------------

Description

PINPK3 sets the pick device to application-specific values.  You specify the initial pick status, the initial pick path, and the pick path order.  Digital PHIGS uses the pick path order to determine the order of the pick path it returns to the PGTPK, PSMPK, and PRQPK functions. 

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 PINPK3, the workstation surface cannot contain the pick device’s prompt.  To remove an existing prompt from the surface, call the PSPKM 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 Pick-Class PETs for information on pick-class prompt and echo types. 

See Also

PGTPK
PINPK
PQDPK3
PQPKS3
PRQPK
PSMPK
PSPKFT
DSPHI
PSPKID
PSPKM