Name

DINCST − Specifies the structure identifier of the structure to be executed. 

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

Syntax

DINCST (STRID)

Argument     Data Type      Access    Description
---------------------------------------------------------------------------
STRID        Integer        Read      Structure identifier
---------------------------------------------------------------------------

Description

DINCST specifies the structure identifier of the structure to be executed. 

Depending on the current edit mode, this function either inserts the new structure directly after the element indicated by the pointer or replaces the element indicated by the pointer.  The element pointer then points to the new include structure element.  If the specified structure does not exist, the function creates a new empty structure. 

This function is the same as PEXST function except that it does not cause a push and pop of the PHIGS attribute stack during structure traversal.  This means that attributes that are changed by the included structure will remain in effect after the traversal of the included structure has been completed. 

The advantage of using this function is simply performance.  If an application does not need the push and pop of the attribute stack, Digital PHIGS does not have to spend time performing this operation. 

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

See Also

DCEXST
DCINST
DCREC
DCSKEL
DCSKLB