delete_segment(3G)

NAME

delete_segment, delete_all_segments, delete_segment_and_references − delete from a display list a segment, all segments, or a segment and all references to it

SYNOPSIS

C Syntax:

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

void delete_all_segments ( fildes )
int fildes;

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

FORTRAN77 Syntax:

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

subroutine delete_all_segments ( fildes )
integer*4 fildes

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

Pascal Syntax:

procedure delete_segment ( fildes, segno:integer );

procedure delete_all_segments ( fildes:integer );

procedure delete_segment_and_references ( 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 delete.

Discussion

Delete_segment removes the specified segment from the display list of the specified graphics device if the specified segment is not referenced by another segment. Otherwise, the specified segment is replaced by an empty segment to satisfy the reference.

Delete_all_segments deletes all segments from the given display list, as well as all segment references.

Delete_segment_and_references removes the specified segment from the specified display list, as well as all segment-referencing elements in that display list that refer to the specified segment. These elements are deleted as if by a call to delete_eles.

If the open segment is deleted, it remains open, but all its elements are deleted.

ERRORS

1 Graphics device is not initialized for this operation.

39 Specified segment does not exist.

Museum

Related Articles