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

GPQLCF - Inquire List of Color Facilities

GPQLCF (wstype, number, ids, errind, data)

Note:

This subroutine is a Workstation Description Table (WDT) inquiry. For an overview, see "WDT Inquiries"

Purpose

Use GPQLCF to inquire one or more groups describing the color facilities for the specified workstation.

If the information is available, then the graPHIGS API sets the error indicator to zero and returns the values in the output parameter. If the inquired information is unavailable, then the error indicator (errind) contains the error number indicating the reason, and the values returned in the output parameter are unpredictable.

Parameters

wstype -- specified by user, 8 byte character string

Workstation type.

number -- specified by user, fullword integer

Number of groups requested (>=1).

ids -- specified by user, array of fullword integers

A list of group identifiers.

errind -- returned by the graPHIGS API, fullword integer

Error indicator. If the error indicator is zero, the request has been completed. Otherwise, one of the following errors exists:
23
SPECIFIED WORKSTATION TYPE DOES NOT EXIST
35
WORKSTATION HAS ONLY INPUT CAPABILITIES
272
GROUP IDENTIFIER IS INVALID
273
NUMBER OF GROUP IDENTIFIERS < ONE
548
SPECIFIED WORKSTATION TYPE CANNOT BE LOADED

data -- returned by the graPHIGS API, array of fullword quantities

Data array. When you specify a list of group identifiers, the data is returned to your application in the order you specified your request. Below is a list of the contents of each group:

Group Identifier 1 - Color model of the workstation

A fullword integer (1=RGB, 2=HSV, 3=CMY, 4=CIELUV )

Group Identifier 2 - Color available on the workstation

A fullword integer (1=MONOCHROME, 2=COLOR )

Group Identifier 3 - Number of available colors (total color palette size)

A fullword integer indicating the number of available colors on the workstation.

Group Identifier 4 - Number of predefined default color table entries

A fullword integer indicating the number of predefined default color table entries.

Group Identifier 5 - Number of definable color processing mode table entries

A fullword integer indicating the number of definable color processing mode table entries.

Group Identifier 6 - Number of predefined color processing mode table entries

A fullword integer indicating the number of predefined color processing mode table entries.

Group Identifier 7 - Order of color components for color quantization

A fullword integer (1=RGB, 2=BGR )

Group Identifier 8 - CIELUV color components

An array of nine floating-point numbers which are the color components for the three monitor primaries (1=RGB ) For each monitor primary, graPHIGS API returns the CIELUV chromaticity coefficients (u', v') and the luminance value Y

Error Codes

None

Related Subroutines

None

RCP code

201339672 (X'0C003318')

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