SET EDGE COLOUR INDEX(3P) — Kubota Pacfic Computer Inc. (29 February 1991)

NAME

SET EDGE COLOUR INDEX − create structure element to set the current edge colour index attribute

SYNOPSIS

C Syntax

void
pset_edge_colr_ind ( index )
Pintindex;edge colour index

Required PHIGS Operating States

(PHOP, ∗, STOP, ∗)

DESCRIPTION

Purpose

SET EDGE COLOUR INDEX creates a structure element containing a value for the current edge colour index attribute. When the current edge colour index Aspect Source Flag (ASF) is set to INDIVIDUAL, this attribute indexes the colour representation that applies to the output primitives:

• FILL AREA SET

• FILL AREA SET 3

• FILL AREA SET 3 WITH DATA

• GENERALIZED DRAWING PRIMITIVE (Fill Area Set Primitives)

• GENERALIZED DRAWING PRIMITIVE 3 (Fill Area Set Primitives)

• NON-UNIFORM B-SPLINE SURFACE

• SET OF FILL AREA SET 3 WITH DATA

• QUADRILATERAL MESH 3 WITH DATA

• TRIANGLE STRIP 3 WITH DATA

C Input Parameter

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

Execution

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

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

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

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

ERRORS

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

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

Museum