NAME

change_segment_references − change call_segment elements to reference a different segment

SYNOPSIS

C Syntax:

void change_segment_references(fildes,old_segno,new_segno)
int fildes,old_segno,new_segno;

FORTRAN77 Syntax:

subroutine change_segment_references(fildes,old_segno,new_segno)
integer*4 fildes,old_segno,new_segno

Pascal Syntax:

procedure change_segment_references(fildes,old_segno,new_segno:integer);

DESCRIPTION

Input Parameters

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

old_segno Old segment name. 

new_segno New segment name. 

Discussion

Change_segment_references operates on all segments in the display list of the specified graphics device replacing all call_segment elements that call old_segno with call_segment elements that call new_segno.  If there are calls to old_segno and the new segment does not exist, new_segno is created.  If there are no calls to old_segno, no changes are made and no error is generated. 

ERRORS

1 Graphics device is not initialized for this operation. 

SEE ALSO

rename_segment(3G), rename_segment_and_references(3G). 

Hewlett-Packard Company  —  December 25, 1986