NAME

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

SYNOPSIS

C Syntax

void

pset_colr_map_ind ( index )

Pint

index;

colour mapping index

FORTRAN Syntax

SUBROUTINE pscmi ( CMI )

INTEGER

CMI

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

index

An index into the workstation colour mapping bundle table.

FORTRAN Input Parameter

CMI

An index into 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 it replaces the element to which the element pointer points. 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 is applied to all primitives subsequently displayed.

ERRORS

005

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

121

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

SEE ALSO

SET COLOUR MAPPING REPRESENTATION (3PP)

INQUIRE LIST OF COLOUR MAPPING INDICES (3PP)