NAME

SET COLOUR MAPPING INDEX − create a structure element to set the colour mapping index

SYNOPSIS

C Syntax

void
pset_colr_map_ind ( index )
Pintindex;colour mapping index

Required PHIGS Operating States

(PHOP, ∗, STOP, ∗)

DESCRIPTION

Purpose

SET COLOUR MAPPING INDEX creates an element in the currently open structure containing a colour mapping index. The index number corresponds to an entry in the table of defined colour mapping representations in the workstation state list. 

C Input Parameter

indexThis is an index to the workstation colour mapping bundle table. 

Execution

Depending on the edit mode, a SET COLOUR MAPPING INDEX element with a value colour mapping index is inserted into the open structure after the element pointer or replaces the element pointed to by the element pointer. The element pointer is then updated to point to this SET COLOUR MAPPING INDEX element. 

When a SET COLOUR MAPPING INDEX structure element is traversed, the current colour mapping index value in the PHIGS Extension traversal state list is set to index. This value indexes a colour mapping representation in the table of defined colour mapping operations stored in the workstation state list.  If the entry corresponding to the specified index is not defined, then an entry of zero is substituted in the index. 

The current colour mapping index determines the colour mapping operation that will be applied to all primitives subsequently displayed. 

ERRORS

005Ignoring function, function requires state (PHOP,∗,STOP,∗)

121Ignoring function, the colour mapping index is less than 0. 

SEE ALSO

SET COLOUR MAPPING REPRESENTATION (3P+)
INQUIRE LIST OF COLOUR MAPPING INDICES (3P+)

September 02, 1992