INQUIRE NUMBER OF DISPLAY PRIORITIES SUPPORTED (PHOP,*,*,*)

Purpose

Use Inquire Number of Display Priorities Supported to inquire the number of display priorities supported for the specified workstation type.

When posting a structure to a workstation, the application specifies a structure priority, which is a real number between 0.0 and 1.0. The graPHIGS API traverses the structures in order, from lowest to highest priority.

The graPHIGS API returns values indicating the total number of supported display priorities. For example, if a workstation uses a 4-bit mask to keep track of priorities, then it is able to support only 16 different priorities and must map the real number to one of 16 values. If a workstation can support a continuous range of display priorities, then the inquiry returns a zero.

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

Input Parameters

Output Parameters

FORTRAN

Input Parameters

Output Parameters