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

INQUIRE PICK DEVICE STATE (PHOP,WSOP,*,*)

Purpose

Use Inquire Pick Device State to inquire the current state of the specified pick device on the specified workstation. Returned values of type SET or REALIZED may be specified.

If the information is available, then the graPHIGS API sets the error indicator to zero and returns the values in the output parameters. If the information is unavailable, then the values returned in the output parameters are unpredictable and the graPHIGS API sets the error indicator to one of the following errors:

3
Function Requires State (PHOP,WSOP,*,*)
54
Specified Workstation Is Not Open
60
Specified Workstation Is Not Of Category Outin
250
Specified Device Not Available On Workstation

Language Bindings

C

pinq_pick_st (ws_id, pick_num, type, store, err_ind, op_mode, echo_switch, pick_filter, init_status, init_pick, prompt_echo, echo_area, pick_data, order)

Input Parameters

Pint ws_id
Workstation identifier.

Pint pick_num
Pick device number (>=1).

Pinq_type type
Type of returned values (0=PINQ_SET, 1=PINQ_REALIZED).

Pstore store
Handle to the store object. The graPHIGS API uses an object of type Store to facilitate the use of subroutines which return complex data. See Create Store ( CREATE STORE (PHOP,*,*,*)) subroutine for details on how the graPHIGS API uses this parameter on inquiries.

Output Parameters

Pint *err_ind
Error indicator.

Pop_mode *op_mode
Operating mode (0=POP_REQ, 1=POP_SAMPLE, 2=POP_EVENT).

Pecho_switch *echo_switch
Echo switch (0=PSWITCH_NO_ECHO, 1=PSWITCH_ECHO).

Pfilter **pick_filter
Pick filter. The memory referenced by *pick_filter is managed by the parameter store.

Pin_status *init_status
Initial pick status (1=PIN_STATUS_OK, 2=PIN_STATUS_NO_IN).

Ppick_path **init_pick
Initial pick path. The memory referenced by *init_pick is managed by the parameter store.

Pint *prompt_echo
Prompt and echo type.

Plimit *echo_area
Echo area in DC.

Ppick_data3 **pick_data
Data record. The memory referenced by *pick_data is managed by the parameter store.

Ppath_order *order
Pick path order (0=PORDER_TOP_FIRST, 1=PORDER_BOTTOM_FIRST).

FORTRAN

PQPKS (wkid, pkdnr, type, mldr, ipissz, ipessz, ippsz, errind, mode, esw, pissz, pins, pessz, pes, istat, ppd, pp, pet, earea, ldr, datrec, ppordr)

Input Parameters

integer wkid
Workstation identifier.

integer pkdnr
Pick device number (>=1).

integer type
Type of returned values (0=PSET, 1=PREALI).

integer mldr
Dimension of data record array (>=0).

integer ipissz
Pick inclusion set buffer size (>=0).

integer ipessz
Pick exclusion set buffer size (>=0).

integer ippsz
Pick path buffer size (>=0).

Output Parameters

integer errind
Error indicator.

integer mode
Operating mode (0=PREQU, 1=PSAMPL, 2=PEVENT).

integer esw
Echo switch (0=PNECHO, 1=PECHO).

integer pissz
Pick inclusion set size.

integer pins(ipissz)
Pick inclusion set.

integer pessz
Pick exclusion set size.

integer pes(ipessz)
Pick exclusion set.

integer istat
Initial pick status (1=POK, 2=PNPICK).

integer ppd
Initial pick path depth.

integer pp(3,ippsz)
Initial pick path.

integer pet
Prompt and echo type.

real earea(4)
Echo area in DC (XMIN, XMAX, YMIN, YMAX).

integer ldr
Number of array elements used in the data record.

character*80 datrec(mldr)
Data record.

integer ppordr
Pick path order (0=PPOTOP, 1=PPOBOT).

Errors

None

Related Subroutines

  • Initialize Pick

  • Initialize Pick 3

  • Inquire Default Pick Device Data

  • Inquire Default Pick Device Data 3

  • Inquire Pick Device State 3


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