INQUIRE COLOUR REPRESENTATION
-
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
SEE ALSO
set colour representation, inquire predefined colour representation, inquire
colour facilities.