PGTPK(3g) — Subroutines
Name
PGTPK − Returns the pick path list.
Operating States: PHOP, WSOP, ∗, ∗
PHIGS standard function
Syntax
PGTPK (IPPD, STAT, PPD, PP)
Argument Data Type Access Description
---------------------------------------------------------------------------
IPPD Integer Read Depth of pick path to return
STAT Integer Write Status
PPD Integer Write Depth of the actual pick path
PP(3, IPPD) Array of Write Pick path (struct_id1, pick_id1,
integers element_number1,... struct_idIPPD,
pick_idIPPD, element_numberIPPD)
---------------------------------------------------------------------------
Constants
Defined Argument Constant Description
---------------------------------------------------------------------------
STAT PNONE User performed a break action.
POK User picked a primitive.
PNPICK User triggered the device, but did not
make a selection.
---------------------------------------------------------------------------
Description
PGTPK obtains information contained in the current event report entry. If the report contains input generated by anything other than a pick-class input device, a call to this function generates an error. (See the PWAIT function for more information about input classes and the current event report entry.)
The pick path is a list Digital PHIGS uses to trace the traversal of the structure hierarchy and to identify uniquely the picked structure. The individual components of the list contain the following integer values:
•Structure identifier
•Pick identifier of the element
•Offset (by element) into the structure
The function returns the pick path in the order (TOPFIRST or BOTTOMFIRST) specified by the pick path order entry in the workstation state list.
See the PINPK function for information about how to establish a pick path order (top first or bottom first).
See Also
PWAIT
PFLUSH
PINPK
PINPK3
PRQPK
PSMPK
PSPKFT
DSPHI
PSPKID
PSPKM