Name

pe_copy_elem − Copies the specified element to the open structure. 

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

Syntax

void pe_copy_elem (
  Pint     struct_id,    /∗ (I) The structure to copy from ∗/
  Pint     element       /∗ (I) Element position ∗/
)

Description

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

See Also

popen_struct