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

INQUIRE COLOR FACILITIES (PHOP,*,*,*)

Purpose

Use Inquire Color Facilities to inquire the color facilities of a specified workstation type.

The graPHIGS API returns the total number of available colors, the color status, (monochrome or color), the quantity of predefined color table entries in the workstation's default color table, and the primary colors for the workstation display. The graPHIGS API returns the primary colors as the CIELUV chromaticity coefficients u, v and luminance value y.

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_colr_facs (ws_type, err_ind, fac)

Input Parameters

Pint ws_type
Workstation type.

Output Parameters

Pint *err_ind
Error indicator.

Pcolr_facs *fac
Color facilities.

FORTRAN

PQCF (wtype, errind, ncoli, cola, npci, cc)

Input Parameters

integer wtype
Workstation type.

Output Parameters

integer errind
Error indicator.

integer ncoli
Number of color indexes.

integer cola
Color available (0=PMONOC, 1=PCOLOR).

integer npci
Number of predefined color indexes.

real cc(9)
Primary colors. Chromaticity coefficients and luminance value for the primaries for the display device (Ru , Rv , RY , Gu , Gv , GY , Bu , Bv , BY).

Errors

None

Related Subroutines

  • None

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