INQUIRE COLOUR FACILITIES(3P) — Kubota Pacfic Computer Inc. (29 February 1991)

NAME

INQUIRE COLOUR FACILITIES − inquire a workstation type’s colour facilities

SYNOPSIS

C Syntax

void
pinq_colr_facs ( type, error_ind, facilities )
Pinttype;workstation type
Pint∗error_ind;OUT error indicator
Pcolr_facs∗facilities;OUT colour facilities

Required PHIGS Operating States

(PHOP, ∗, ∗, ∗)

DESCRIPTION

Purpose

Use INQUIRE COLOUR FACILITIES to obtain a description of colour facilities for the specified type of workstation.

C Input Parameter

typeGet the colour facilities for this workstation type.

C Output Parameters

error_ind
A pointer to the location to store the error number of any error detected by this function.

facilities
A pointer to the structure in which to store the information, defined as:

typedef struct {
Pintnum_colrs;/∗ number of colours ∗/
Pcolr_availcolr_avail;/∗ colour availability ∗/
Pintnum_pred_inds; /∗ number of predefined bundles ∗/
Pcieluvprim_colrs;/∗ primary colours ∗/
} Pcolr_facs;

colr_avail returns the colour availability, one of the following enumeration values:

PAVAIL_COLRColour
PAVAIL_MONOCHRMonochrome

num_pred_inds returns the number of predefined colour bundle indices.

prim_colrs returns the three primary colours CIE (Commission Internationale de l’Eclairage’s universal colour definition system) chromaticity coefficients, defined as:

typedef struct {
Pfloatcieluv_x;/∗ x coefficient ∗/
Pfloatcieluv_y;/∗ y coefficient ∗/
Pfloatcieluv_y_lum; /∗ y luminance ∗/
} Pcieluv;

The z primary chromaticity coefficients may be calculated by 1.0 − x − y.

Note: PEX-SI does not support the CIE colour model, so 0.0 is returned for all the chromaticity coefficients.

ERRORS

002Ignoring function, function requires state (PHOP, ∗, ∗, ∗)

052Ignoring function, workstation type not recognized by the implementation

051Ignoring function, this information is not yet available for this workstation type; open a workstation of this type and use the specific workstation type

059Ignoring function, the specified workstation does not have output capability (that is, the workstation category is neither OUTPUT, OUTIN, nor MO)

062Ignoring function, this information is not available for this MO workstation type

Museum