Name

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

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

Syntax

void pe_incl_struct (
  Pint    stid    /∗ (I) Structure identifier ∗/
)

Description

pe_incl_struct 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 pexec_struct 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

pe_cond_exec_struct
pe_cond_incl_struct
pe_cond_return
pe_cond_skip_elems
pe_cond_skip_label