SET COLOUR MAPPING INDEX

PSCMI

CALL SEQUENCE

CALL PSCMI(CMI)

INPUT PARAMETERS

INTEGER CMI

colour mapping index

PHIGS STATE

EFFECT

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

When an element of this type is interpreted, the current colour mapping index entry in the traversal state list is set to the value associated with the element. This value is used when displaying subsequent output primitives.

When an element of this type is interpreted, if the specified entry is not available on a workstation, the entry corresponding to an index value of 1 is used.

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

121

Ignoring function, the colour mapping index is less than one

SEE ALSO

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