SET COLOUR REPRESENTATION

PSCR

CALL SEQUENCE

CALL PSCR (WKID, CI, OL, CSPEC)

INPUT PARAMETERS

INTEGER WKID

Workstation identifier

INTEGER CI

Colour index

INTEGER OL

Number of components of colour specification

REAL CSPEC(OL)

Colour specification

PHIGS STATE

EFFECT

The colour components are placed in the colour bundle table at index CI in the workstation state list.

The colour is specified by its components in the current colour model, as defined in the current colour model entry in the workstation state list.

When the primitives are displayed, during traversal, the current colour index in the PHIGS traversal state list refers to the corresponding entry in the WKID workstation colour table.

The background colour of the workstation is defined by colour index 0.

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)

103

Ignoring function, setting this bundle table entry would exceed the maximum number of entries allowed in the workstation

110

Ignoring function, the specified colour model is not available on the workstation

113

Ignoring function, the colour index value is less than zero

118

Ignoring function, one of the components of the colour specification is out of range. The valid range is dependent upon the current colour model

SEE ALSO

set polyline colour index, set polymarker colour index, set text colour index, set interior colour index, set edge colour index, set color model, inquire colour representation, inquire predefined colour representation, inquire colour facilities, inquire workstation state table length