Name

DSHI − Creates or redefines the highlight index. 

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

Syntax

DSHI (HI)

Argument       Data Type      Access     Description
---------------------------------------------------------------------------
HI             Integer        Read       Highlight index
---------------------------------------------------------------------------

Description

DSHI creates or redefines the highlight index.  Depending on the edit mode, this function either inserts the new structure element with the value index directly after the element indicated by the pointer or replaces the element indicated by the pointer.  The pointer then points to the new set highlight index element. 

During structure traversal, Digital PHIGS sets the current highlight index entry in the PHIGS traversal state list to the value specified by the parameter.  Digital PHIGS uses this value when highlighting subsequent output primitives. 

During structure traversal, if the specified highlight index is unavailable on a workstation, Digital PHIGS uses highlight index 1. 

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

See Also

DQHLFA
DSHR
DSPHI