SET TEXT COLOUR INDEX

PSTXCI

CALL SEQUENCE

CALL PSTXCI (COLI)

INPUT PARAMETERS

INTEGER COLI

Text colour index

PHIGS STATE

EFFECT

A SET TEXT COLOUR INDEX element is inserted in the open structure after element pointer or replaces the element indicated by element pointer, depending on edit mode. Element pointer then points to the SET TEXT COLOUR INDEX element. The value specified by COLI is associated with the element.

When an element of this type is interpreted, the current text colour index entry in the PHIGS traversal state list is set to COLI. This value is used to display the text primitives which follow when the current text colour index ASF entry in the PHIGS traversal state list is INDIVIDUAL. When the value is BUNDLED, COLI has no effect.

EXTENSION TO THE PHIGS STANDARD

If GPHIGS is in NRS mode, the effect of this function is different from the effect described in the standard.

In NRS mode, (see OPEN PIPE), the element is not stored in a structure. It is sent to the workstation on which the pipe is opened.

ERRORS

5

Ignoring function, function requires state (PHOP,*, STOP,*)

113

Ignoring function, the colour index value is less than zero

SEE ALSO

text, annotation text relative, set colour representation, set text colour, open structure, open pipe (ext), inquire current element content, inquire current element type and size