Name

DCELRA − Copies a range of elements to the open structure. 

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

Syntax

DCELRA (STRID, EP1, EP2)

Argument     Data Type       Access   Description
---------------------------------------------------------------------------
STRID        Integer         Read     Structure identifier
EP1, EP2     Integer         Read     Element range boundary
---------------------------------------------------------------------------

Description

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

Regardless of the current edit mode, this function inserts the copied structure elements directly after the element indicated by the pointer.  The pointer then points to the last structure element. 

The element range includes all the structure elements between and including the lower and higher element positions.  Digital PHIGS uses the element with the lesser value as the lower element position, and the element with the higher value as the higher element position.  Therefore, you do not need to specify the elements in order. 

If an element position is greater than the total number of elements in the structure, Digital PHIGS uses the value pointing to the last element in the specified structure.  If the specified element position is less than 1, Digital PHIGS uses the value 0.  If both of the resulting positions are equal to zero, 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