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

INQUIRE WORKSTATION CATEGORY (PHOP,*,*,*)

Purpose

Use Inquire Workstation Category to inquire the category of the specified workstation type.

The graPHIGS API returns the category of the workstation type indicating whether it is output (OUTPUT), input (INPUT), output and input (OUTIN), metafile output (MO), or metafile input (MI).

If the information is available, then the graPHIGS API sets the error indicator to zero and returns the workstation category in the output parameter. If the information is unavailable, then the value returned in the output parameter is unpredictable and the graPHIGS API sets the error indicator to one of the following errors:

2
Function Requires State (PHOP,*,*,*)
52
Workstation Type Not Recognized By Implementation
51
Information Not Available For Generic Workstation Type

Language Bindings

C

pinq_ws_cat (ws_type, err_ind, cat)

Input Parameters

Pint ws_type
Workstation type.

Input Parameters

Pint *err_ind
Error indicator

Pws_cat *cat
Workstation category (0=PCAT_OUT, 1=PCAT_IN, 2=PCAT_OUTIN, 3=PCAT_MO, 4=PCAT_MI).

FORTRAN
PQWKCA (wtype, errind, wkcat)

Input Parameters

integer wtype
Workstation type.

Output Parameters

integer errind
Error indicator.

integer wkcat
Workstation category (0=POUTPT, 1=PINPUT, 2=POUTIN, 3=PMO, 4=PMI).

Errors

None

Related Subroutines

  • Inquire Workstation Connection And Type

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