inq_segment_count(3G)

NAME

inq_segment_count, inq_segment_list, inq_segment_exists − return information about segments in specified display list

SYNOPSIS

C Syntax:

void inq_segment_count(fildes, count)
int fildes, *count;

void inq_segment_list(fildes, list)
int fildes, list[];

void inq_segment_exists(fildes, segno, exists)
int fildes, segno, *exists;

FORTRAN77 Syntax:

subroutine inq_segment_count(fildes, count)
integer*4 fildes, count;

subroutine inq_segment_list(fildes, list)
integer*4 fildes, list(*);

subroutine inq_segment_exists(fildes, segno, exists)
integer*4 fildes, segno, exists

Pascal Syntax:

procedure inq_segment_count(fildes:integer;var count:integer);

procedure inq_segment_list(fildes:integer;var list:
array[lo..hi :integer] of integer);

procedure inq_segment_exists(fildes, segno:integer;
var exists:integer);

DESCRIPTION

Input Parameters

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

segno Segment name.

Output Parameters

count Number of existing segments in the display list.

list List of display list segment names.

exists Segment existence flag:

FALSE (0): segment does not exist
TRUE (1): segment exists.

Discussion

Inq_segment_count, inq_segment_list, and inq_segment_exists return information about the segments in the display list of the specified graphics device.

Inq_segment_count sets count to the number of segments in the display list of the specified graphics device.

Inq_segment_list returns, in list, a list of names of the segments in the display list of the specified graphics device. List should be large enough for at least count elements.

Inq_segment_exists sets exists to TRUE (1) if the specified segment exists in the display list of the specified graphics device. Otherwise, it sets exists to FALSE (0).

ERRORS

1 Graphics device not initialized for this operation.

Museum

Related Articles