[ Previous | Next | Contents | Glossary | Home | Search ]
The graPHIGS Programming Interface: ISO PHIGS Subroutine Reference

SAMPLE PICK (PHOP,WSOP,*,*)

Purpose

Use Sample Pick to immediately retrieve the current measure of the specified pick device.

The graPHIGS API returns the pick path information in the order specified in the Initialize Pick subroutine, that is, TOP FIRST or BOTTOM FIRST. If your application has not called Initialize Pick, then the pick path order defaults to TOP FIRST.

If the measure of the pick device indicates no pick, then the graPHIGS API returns a status of NOPICK Otherwise, the graPHIGS API returns a status of OK together with a pick path which is set according to the current measure of the pick device. Each entry in the pick path consists of a structure identifier, a pick identifier, and an element position.

Language Bindings

C

psample_pick (ws_id, pick_num, depth, pick_in_status, pick)

Input Parameters

Pint ws_id
Workstation identifier.

Pint pick_num
Pick device number (>=1).

Pint depth
Maximum depth of pick path to return.

Output Parameters

Pin_status *pick_in_status
Pick input status (1=PIN_STATUS_OK, 2=PIN_STATUS_NO_IN).

Ppick_path *pick
Pick path.

FORTRAN

PSMPK (wkid, pkdnr, ippd, stat, ppd, pp)

Input Parameters

integer wkid
Workstation identifier.

integer pkdnr
Pick device number (>=1).

integer ippd
Maximum depth of pick path to return.

Output Parameters

integer stat
Pick input status (1=POK, 2=PNPICK).

integer ppd
Depth of the actual pick path.

integer pp (3,ippd)
Pick path.

Errors

3
Function Requires State (PHOP,WSOP,*,*)
54
Specified Workstation Is Not Open
61
Specified Workstation Is Not Of Category Input Or Outin
250
Specified Device Not Available On Workstation
252
Function Requires Input Device To Be In Sample Mode

Related Subroutines

  • Inquire Number Of Available Logical Input Devices

  • Set Pick Mode

    • [ Previous | Next | Contents | Glossary | Home | Search ]