Name

PSPLCI − Defines a polyline color index. 

Operating States: PHOP, ∗, STOP, ∗
PHIGS standard function
Creates a structure element

Syntax

PSPLCI (COLI)

Argument        Data Type     Access     Description
---------------------------------------------------------------------------
COLI            Integer       Read       Color index
---------------------------------------------------------------------------

Description

PSPLCI creates or redefines a polyline color index that points to an entry in the workstation color table.  Depending on the current edit mode, this function either inserts the new structure element directly after the element indicated by the pointer or replaces the element indicated by the pointer. The pointer then points to the new set polyline color index element. 

The set polyline color index element has the following effects during structure traversal:

•Digital PHIGS sets the current polyline color index entry in the PHIGS traversal state list to the specified value. If the corresponding current polyline color index ASF entry is INDIVIDUAL, Digital PHIGS uses the polyline color index value when traversing subsequent polyline and polyline 3 primitives.  If the ASF value is BUNDLED, this function has no effect on primitives created subsequent to the call. 

•Digital PHIGS uses index value 1 if the requested polyline color index is not available on the workstation. 

If Digital PHIGS is in immediate mode, it performs this function immediately, but the function does not create a structure element. 

See the PSPLI function for information about defining a bundled polyline color index value. 

See Also

PATR
PATR3
PBSC3
PPL
PPL3
DPLS
DPLS3
PPLS3C
PSCR
PSIASF
PSPLC
PSPLR