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

INQUIRE PREDEFINED COLOR REPRESENTATION (PHOP,*,*,*)

Purpose

Use Inquire Predefined Color Representation to inquire the color values in the predefined color table entry in the color table of the specified workstation. The color specification parameters are the coordinates of the color in the default color model as defined in the workstation description table (WDT).

The graPHIGS API returns the predefined color specification corresponding to the specified index.

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
113
Color Index Value < ZERO
102
Representation Has Not Been Predefined On This Workstation

Language Bindings

C

pinq_pred_colr_rep (ws_type, colr_ind, err_ind, colr_rep)

Input Parameters

Pint ws_type
Workstation type.

Pint colr_ind
Predefined color index (>=0).

Output Parameters

Pint *err_ind
Error indicator.

Pcolr_rep *colr_rep
Predefined color representation.

FORTRAN

PQPCR (wtype, pci, ccsbsz, errind, ol, cspec)

Input Parameters

integer wtype
Workstation type.

integer pci
Predefined color index (>=0).

integer ccsbsz
Color component specification buffer size (>=0).

Output Parameters

integer errind
Error indicator.

integer ol
Number of color components in the color specification.

real cspec(ccsbsz)
Color specification.

Errors

None

Related Subroutines

  • Inquire Workstation Connection And Type

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