Name

DCEL − Copies the specified element to the open structure. 

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

Syntax

DCEL (STRID, ELEPOS)

Argument     Data Type       Access   Description
---------------------------------------------------------------------------
STRID        Integer         Read     Structure identifier
ELEPOS       Integer         Read     Element position from which to copy
---------------------------------------------------------------------------

Description

DCEL copies the element at the specified element position to the open structure.  The original structure is unchanged unless it is also the open structure. 

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 copy element from structure element. 

If the specified element position is greater than the total number of elements in the structure, Digital PHIGS uses the  last element in the specified structure.  If the specified element position is less than 1, Digital PHIGS does not modify the open structure. 

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

Digital PHIGS Version 3.1 does not support this function.

See Also

POPST