INQUIRE COLOUR FACILITIES(3P) — SUNPHIGS LIBRARY

NAME

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

SYNOPSIS

C Syntax

void
pinqcolourfacil ( type, error_ind, facilities )
Pwstypetype;workstation type
Pint∗error_ind;OUT error indicator
Pcofac∗facilities;OUT colour facilities

FORTRAN Syntax

SUBROUTINE pqcf ( WTYPE, ERRIND, NCOLI, COLA, NPCI, CC )
INTEGERWTYPEworkstation type
INTEGERERRINDOUT error indicator
INTEGERNCOLIOUT number of colours
INTEGERCOLAOUT colour available (PMONOC, PCOLOR)
INTEGERNPCIOUT number of predefined colour indices
REALCC(6)OUT primary colour chromaticity coefficients

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 {
Pintcolours;/∗ number of colours ∗/
Pcoavailcoavail;/∗ colour availability ∗/
Pintpredefined;/∗ number of predefined bundles ∗/
Pchromcoeffprimary[3];/∗ primary colours ∗/
} Pcofac;

Colours returns the number of colours (or intensities) displayable, or zero to indicate that a continuous range of colours is supported.

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

PCOLOURColour
PMONOCHROMEMonochrome

Predefined returns the number of predefined colour bundles.

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

typedef struct {
Pfloatx;/∗ x primary chromaticity coefficient ∗/
Pfloaty;/∗ y primary chromaticity coefficient ∗/
} Pchromcoeff;

The z primary chromaticity coefficients may be calculated by 1.0 - x - y. Note: SunPHIGS does not support the CIE colour model, so 0.0 is returned for all the chromaticity coefficients.

FORTRAN Input Parameter

WTYPE
Get the colour facilities for this workstation type.

FORTRAN Output Parameters

ERRIND
The error number of any error detected by this function.

NCOLI
NCOLI is either the number of colours or intensities displayable, or zero to indicate that a continuous range of colours is supported.

COLACOLA is the colour availability, one of the following enumeration values:

PMONOCMonochrome
PCOLORColour

NPCINPCI is the number of predefined colour bundles.

CCThe three primary colours’ CIE (Commission Internationale de l’Eclairage’s universal colour definition system); chromaticity coefficients. They are ordered: x coefficient of red, y coefficient of red, x coefficient of green, y coefficient of green, x coefficient of blue, y coefficient of blue. The z primary chromaticity coefficients may be calculated by 1.0 - x - y. Note: SunPHIGS 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 (i.e., the workstation category is neither OUTPUT, OUTIN, nor MO)

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

Museum

Related Articles