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

INQUIRE LIST OF AVAILABLE GENERALIZED STRUCTURE ELEMENTS (PHOP,*,*,*)

Purpose

Use Inquire List of Available Generalized Structure Elements to inquire a list of available Generalized Structure Element (GSE) identifiers for the specified workstation type.

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:

2
Function Requires State (PHOP,*,*,*)
52
Workstation Type Not Recognized By Implementation
51
Information Not Available For Generic Workstation Type
59
Specified Workstation Does Not Have Output Capability
62
This Information Not Available For MO Workstation Type

Language Bindings

C

pinq_list_avail_gse (ws_type, num_elems_appl_list, start_ind, err_ind, gses, num_elems_impl_list)

Input Parameters

Pint ws_type
Workstation type.

Pint num_elems_appl_list
Number of elements in the application list (>=0).

Pint start_ind
Starting index (>=0).

Output Parameters

Pint *err_ind
Error indicator.

Pint_list *gses
List of available GSEs.

Pint *num_elems_impl_list
Number of elements in the implementation list.

FORTRAN

PQEGSE (wtype, n, errind, ngse, gsel)

Input Parameters

integer wtype
Workstation type.

integer n
List element requested (>=0).

Output Parameters

integer errind
Error indicator.

integer ngse
Number of available GSEs.

integer gsel
nth element in the list of available GSE identifiers.

Errors

None

Related Subroutines

  • Inquire Workstation Connection And Type


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