NAME

copy_segment − copy contents of the specified segment into the currently open segment

SYNOPSIS

C Syntax:

void copy_segment(fildes, segno)
int fildes, segno;

FORTRAN77 Syntax:

subroutine copy_segment(fildes, segno)
integer*4 fildes, segno

Pascal Syntax:

procedure copy_segment(fildes, segno:integer);

DESCRIPTION

Input Parameters

fildes Integer file descriptor returned by gopen when an I/O path to a graphics device is opened. 

segno Name of the segment to copy. 

Discussion

Copy_segment copies the contents of the specified segment from the display list of the specified graphics device into the currently open segment of the same graphics device.  The copied elements are placed after the current element.  After the copy is complete, the element pointer is set such that any more new elements will be added immediately following the copied segment, i.e., the element pointer is left pointing to the last element copied. 

If in replace mode, the first element copied replaces the current element.  Replace mode is then exited and remaining elements are inserted after the replaced element. 

ERRORS

1 Graphics device is not initialized for this operation. 

24 Segment not open. 

25 Duplicate segment name - the specified segment is already open.  A segment cannot be copied into itself. 

39 Specified segment does not exist. 

SEE ALSO

open_segment(3G), replace_ele(3G). 

Hewlett-Packard Company  —  HP-UX Release 9.03: April 1994