NAME

SET POLYLINE COLOUR INDEX − create structure element to set the current polyline colour index attribute

SYNOPSIS

C Syntax

void
pset_line_colr_ind ( colour )
Pintcolour;polyline colour index

Required PHIGS Operating States

(PHOP, ∗, STOP, ∗)

DESCRIPTION

Purpose

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

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

• POLYLINE

• POLYLINE 3

• POLYLINE SET 3 WITH DATA

• NON-UNIFORM B-SPLINE CURVE

• ANNOTATION TEXT RELATIVE (when “connected” style is in use)

• ANNOTATION TEXT RELATIVE 3 (when “connected” style is in use)

• CELL ARRAY (when minimal simulation is performed)

• CELL ARRAY 3 (when minimal simulation is performed)

C Input Parameter

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

Execution

If the current edit mode is INSERT, a SET POLYLINE 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 POLYLINE 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 POLYLINE COLOUR INDEX element is traversed, the current polyline colour index entry in the traversal state list is set to the colour index. 

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

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

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

ERRORS

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

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

SEE ALSO

COLOUR (7P)
SET COLOUR REPRESENTATION (3P)
SET INDIVIDUAL ASF (3P)
SET POLYLINE REPRESENTATION (3P)
SET POLYLINE COLOUR (3P+)

September 02, 1992