Name

PSTXCI − Uses a text color index to provide a pointer to the workstation color table. 

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

Syntax

PSTXCI (COLI)

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

Description

PSTXCI uses a text color index to provide a pointer into the color table of the workstation.  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 text color index element. 

During structure traversal, the set text color index element sets the current text color index entry in the PHIGS traversal state list to the specified value.  If the current text color index ASF entry in the PHIGS traversal state list is INDIVIDUAL, Digital PHIGS uses the text color index value when traversing subsequent text, text 3, annotation text, and annotation text 3 primitives.  If the ASF setting is BUNDLED, the value has no effect.  Digital PHIGS uses the default color if the specified text color is not available at the workstation during structure traversal. 

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

See Also

PATR
PATR3
PSCR
PSIASF
PSTXC
PSTXR
PSTXRP
PTX
PTX3