SET TEXT COLOUR

PSTXC

CALL SEQUENCE

CALL PSTXC(CTYPE, NCC, COLI, COLR)

INPUT PARAMETERS

INTEGER CTYPE

Text colour type

INTEGER NCC

Number of components of colour value

INTEGER COLI

Colour index

REAL COLR(NCC)

Colour components

PHIGS STATE

EFFECT

A SET TEXT COLOUR 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 element. The value specified by the parameter is associated with the element.

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

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,*)

SEE ALSO

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