INQUIRE DIRECT COLOUR MODEL FACILITIES(3P+) — MISC. REFERENCE MANUAL PAGES

NAME

INQUIRE DIRECT COLOUR MODEL FACILITIES − inquire list of workstation direct colour facilities

SYNOPSIS

C Syntax

void
pinqdirectcolourmodelfacil ( wstype, length, start, error_ind, total_length, facilities )
Pwstypewstype;workstation type
Pintlength;length of list requested
Pintstart;starting position
Pint∗error_ind;OUT error indicator
Pint∗total_length;OUT length of list in PHIGS
Pintlst∗facilities;OUT direct colour models

FORTRAN Syntax

SUBROUTINE pqdcmf ( WKTYPE, ICM, ERRIND, NICM, CMI )
INTEGERWKTYPEworkstation type
INTEGERICMindex into the colour model list
INTEGERERRINDOUT error indicator
INTEGERNICMOUT number of colour models
INTEGERCMIICM-th element of colour models

Required PHIGS Operating States

(PHOP, ∗, ∗, ∗)

DESCRIPTION

Purpose

INQUIRE DIRECT COLOUR MODEL FACILITIES inquires a list of workstation direct colour facilities.

This is a SunPHIGS Extension function based on PHIGS+ and is not part of the PHIGS standard.

C Input Parameters

All of the following data types are predefined in phigs.h.

wstypeThe workstation type.

lengthThe number of elements requested.

startThe starting position.

C Output Parameters

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

total_length
A pointer to the location to store the total length of the list.

facilities
A pointer to a Pintlst which returns the portion of the list of available colour models from the workstation description table, starting with start. Pintlst is defined in phigs.h as:

typedef struct {
Pint number;/∗ number of integers ∗/
Pint∗integers;/∗ list of integers ∗/

} Pintlst; The pointer to the list of integers must be initialized to an array of length Pint elements.

FORTRAN Input Parameters

WKTYPE
The workstation type.

ICMThe index of the entry desired from the list of colour models.

FORTRAN Output Parameters

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

NICMThe number of colour models.

CMIThe requested entry from the list of colour models. The valid values are:

0PINDIRColour Index Specified
1PRGBRed, Green, and Blue
2PCIECIE Colour Model
3PHSVHue, Saturation, and Value
4PHLSHue, Lightness, and Saturation

Execution

If the inquired information is available, the error indicator is returned as zero and values are returned in the output parameters.

If the inquired information is not available, the values returned in the output parameters are undefined and the error indicator is set to one of the following error numbers to indicate the reason for nonavailability.

Since this is an inquiry function, ERROR HANDLING is not invoked when an error is detected by this function.

ERRORS

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

051Ignoring function, this information unavailable for this workstation type

052Ignoring function, workstation type not recognized by the implementation

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

Museum