[ Previous |
The graPHIGS Programming Interface : Subroutine Reference
GPCPER - Copy Element Range
GPCPER to copy a range of elements from a
and to insert the range of elements
into the open structure following the
current element pointer.
The element pointer moves to the last element copied into
the open structure.
If the value for
elem1 is greater than the
elem2, then the values are swapped.
(The element range always starts at the lowest value
and ends at the highest value.)
If both values point beyond the last element of the
specified structure or if both values are less than one,
then the graPHIGS API does not perform the copy.
If one of the values is less than one, then the value
defaults to a value of one.
If one of the values is greater than the number of
elements in the specified structure, then the element number
of the last element in that structure is used instead.
The value of the edit mode set by
does not affect the functionality of this subroutine.
If the elements to be copied contain an execute
structure-type element that references the open structure,
then the graPHIGS API issues an error message and does not
perform the copy.
strid -- specified by user, fullword integer
Identifier of the structure which has elements that are copied.
elem1 -- specified by user, fullword integer
Element number of the first element to copy.
elem2 -- specified by user, fullword integer
Element number of the last element to copy.
- FUNCTION REQUIRES STATE STOP
- ATTEMPTING TO EXECUTE THE OPEN STRUCTURE
- Conditional Execute Structure
- Copy Structure
- Execute Structure
[ Previous |