SET POLYMARKER COLOUR INDEX(3P) — SUNPHIGS LIBRARY

NAME

SET POLYMARKER COLOUR INDEX − create a structure element to set the current polymarker colour index attribute

SYNOPSIS

C Syntax

void
psetmarkercolourind ( index )
Pintindex;polymarker colour index

FORTRAN Syntax

SUBROUTINE pspmci ( COLI )
INTEGERCOLIpolymarker colour index

Required PHIGS Operating States

(PHOP, ∗, STOP, ∗)

DESCRIPTION

Purpose

SET POLYMARKER COLOUR INDEX creates a structure element containing a value for the current polymarker colour index attribute.

When the current polymarker colour index Aspect Source Flag (ASF) is set to INDIVIDUAL, this attribute indexes the current colour representation which applies to the following output primitives:

• POLYMARKER

• POLYMARKER 3

C Input Parameter

indexAn integer colour index, which selects a colour value from the workstation’s colour table.

FORTRAN Input Parameter

COLIAn integer colour index, which selects a colour value from the workstation’s colour table.

Execution

If the current edit mode is INSERT, a SET POLYMARKER COLOUR INDEX element is inserted into the currently open structure after the element pointed to by the current element pointer. If the edit mode is REPLACE, the new SET POLYMARKER COLOUR INDEX element replaces the element pointed to by the element pointer. In either case, the element pointer is updated to point to the new element.

When the SET POLYMARKER COLOUR INDEX element is traversed, the current polymarker colour index entry in the PHIGS traversal state list is set to the colour index.

When the current polymarker colour index ASF is set to INDIVIDUAL, the polymarker output primitives which follow in the structure network are drawn with the colour representation selected by the current polymarker colour index from the workstation’s colour table.

If the colour index specified is not available on the workstation, colour index 1 will be used.

When the current polymarker colour index ASF is set to BUNDLED, the polymarker colour index is taken from the workstation’s representation indicated by the current polymarker index. In this case, the colour index set with SET POLYMARKER COLOUR INDEX has no effect.

ERRORS

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

113Ignoring function, the colour index value is less than zero

Museum