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. 

SEE ALSO

delete_segment(3G), open_segment(3G). 

Hewlett-Packard Company  —  HP-UX Release 10.0