REQUEST PICK
CALL SEQUENCE
PRQPK (WKID,PKDNR,IPPD, STAT, PPD, PP)
INPUT PARAMETERS
INTEGER WKID
INTEGER PKDNR
INTEGER IPPD
OUTPUT PARAMETERS
INTEGER STAT
INTEGER PPD
INTEGER PP(3,IPPD)
ARGUMENTS
- WKID
- Workstation identifier.
- PKDNR
- Pick device number.
- IPPD
- Depth of path to be returned.
- STAT
- Event state.
- POK:
- 1 (OK)
- PNPICK:
- 2 (NOPICK)
- PPD
- Depth of path found in the designated network.
- PP(3,IPPD)
- Path describing the entity found. It is a series of triplets (structure
identifier, element number, pick identifier) exactly describing the primitive
selected in the CSS.
PHIGS STATE
(PHOP, WSOP, *, *).
EFFECT
Request a graphic structure element by user action on the left mouse button of
the active device PKDNR with the possibility of cancelling the input by
activating the device break by clicking on the right button of the mouse. A
third state is possible for the status variable when no graphic entity is
detected.
Example:
C Request pick
INTEGER WKID,PKDNR,IPPD,STAT,PPD,PP(3,5)
.....
WKID = 1
PKDNR = 1
IPPD = 5
call PRQPK(WKID,PKDNR,IPPD,STAT,PPD,PP)
......
ERRORS
- 3
Ignoring function, function requires state (PHOP, WSOP,*,*)
- 54
- Ignoring function, the specified workstation is not open
- 61
- Ignoring function, specified workstation is neither of category INPUT nor
of category OUTIN
- 250
- Ignoring function, the specified device is not available on the specified
workstation
- 251
- Ignoring function, the function requires the input device to be in REQUEST
mode
SEE ALSO
set pick mode, initialize pick, sample pick, get pick, await event, inquire
pick device state, inquire default pick device state 3, pick without
interaction (ext)