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

REQUEST PICK (PHOP,WSOP,*,*)

Purpose

Use Request Pick to have the graPHIGS API execute a request to 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 defaults to TOP FIRST.

A status of NONE means that a break action occurred. 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 the graPHIGS API sets 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

preq_pick (ws_id, pick_num, depth, in_status, pick)

Input Parameters

Pint ws_id
Workstation identifier.

Pint pick_num
Pick device number (>=1).

Pint depth
Maximum depth of the returned pick path.

Output Parameters

Pin_status *in_status
Input status (0=PIN_STATUS_NONE, 1=PIN_STATUS_OK, 2=PIN_STATUS_NO_IN).

Ppick_path *pick
Requested pick path.

FORTRAN

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

Input Parameters

integer wkid
Workstation identifier.

integer pkdnr
Pick device number (>=1).

integer ippd
Maximum depth of the returned pick path.

Output Parameters

integer stat
Input status (0=PNONE, 1=POK, 2=PNPICK).

integer ppd
Depth of the actual pick path.

integer pp (3,ippd)
Requested 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
251
Function Requires Input Device To Be In Request Mode

Related Subroutines

  • Add Names To Set

  • Initialize Pick

  • Inquire Number Of Available Logical Input Devices

  • Remove Names From Set

  • Set Pick Filter

  • Set Pick Identifier

  • Set Pick Mode

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