GPHIGS F77 FUNCTIONS - INQUIRE COLOUR REPRESENTATION

INQUIRE COLOUR REPRESENTATION

PQCR

CALL SEQUENCE

CALL PQCR (WKID, COLI, CCSBSZ, TYPE, ERRIND, OL, CSPEC)

INPUT PARAMETERS

INTEGER WKID

Workstation identifier.

INTEGER COLI

Requested color index.

INTEGER CCSBSZ

Colour component specification buffer size.

INTEGER TYPE

Type of value returned

PSET :: 0 (SET)
PREALI :: 1 (REALIZED)

OUTPUT PARAMETERS

INTEGER ERRIND: Error indicator
INTEGER OL: Number of colour component in the color specification..
REAL CSPEC (CCSBSZ): Colour specification.

PHIGS STATE

(PHOP, WSOP, *, *).

EFFECT

Returns the components contained in the index colour representation of the colour list in workstation WKID's workstation state list. If the data is available, error indicator is returned as 0.

The components are the colour coordinates in the current colour model.

If the value type returned is PREALI, and if the colour associated with the index has never been either predefined or positioned, or if the colour index is greater than the number of colour indexes in the workstation state list, then the colour coordinates are set to the index 1 colour coordinates.

If the value type returned is PSET and if the colour associated with the index has been predefined or positioned, the components are set to the closest values possible to the components associated with the colour index as it was defined; where the value returned is PREALI they are the same.

If the value type returned is PSET and if the colour index has never been either predefined or positioned, error 101 is returned in the error indicator.

ERRORS

3: Ignoring function, function requires state (PHOP, WSOP,*,*)
54: Ignoring function, the specified workstation is not open
59: Ignoring function, the specified workstation does not have output capability (i.e. the workstation category is neither OUTPUT, OUTIN, nor MO)
113: Ignoring function, the colour index value is less than zero
101: Ignoring function, the specified representation has not been defined