Name

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

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

Syntax

void pe_copy_elem_range (
  Pint     struct_id,    /∗ (I) The structure to copy from ∗/
  Pint     start_elem,   /∗ (I) Starting element ∗/
  Pint     end_elem      /∗ (I) Ending element ∗/
)

Description

pe_copy_elem_range 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 4.1 does not support this function.

See Also

popen_struct