Name

PSTXI − Sets the text index value. 

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

Syntax

PSTXI (TXI)

Argument       Data Type      Access     Description
---------------------------------------------------------------------------
TXI            Integer        Read       Text index
---------------------------------------------------------------------------

Description

PSTXI sets the text index value, which points to the workstation text bundle 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 element pointer then points to the new set text index element. 

During structure traversal, Digital PHIGS sets the current text index entry in the PHIGS traversal state list to the specified value.  Digital PHIGS uses the value to create subsequent text, text 3, annotation text, and annotation text 3 primitives when the corresponding ASF is BUNDLED. 

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

To determine the workstation-specific, predefined text bundle tables, run the program phigs_predef.  You can change text bundle table index values with the PSTXR attribute function. 

See Also

PATR
PATR3
PQTXR
PSIASF
PSTXR
PSTXRP
PTX
PTX3