inq_open_segment(3G)

NAME

inq_open_segment − return information about the currently open segment

SYNOPSIS

C Syntax:

void inq_open_segment(fildes, segno, seg_open)
int fildes, *segno, *seg_open;
void inq_open_segment_and_mode(fildes, segno, seg_open, mode)
int fildes, *segno, *seg_open, *mode;

FORTRAN77 Syntax:

subroutine inq_open_segment(fildes, segno, seg_open)
integer*4 fildes, segno, seg_open
subroutine inq_open_segment_and_mode(fildes, segno, seg_open, mode)
integer*4 fildes, segno, seg_open, mode

Pascal Syntax:

procedure inq_open_segment(fildes:integer;
var segno, seg_open:integer);
procedure inq_open_segment_and_mode(fildes:integer;
var segno, seg_open, mode:integer);

DESCRIPTION

Input Parameters

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

Output Parameters

segno Name of currently open segment.

seg_open Flag indicating whether there is an open segment:

FALSE (0): no open segment
TRUE (1): segment open

mode Display mode of the segment as set by open_segment.

Discussion

Inq_open_segment and inq_open_segment_and_mode return information about the currently open segment of the specified graphics device.

If a segment is open, inq_open_segment and inq_open_segment_and_mode return the name of the currently open segment in segno and seg_open is set to TRUE (1). If a segment is not open, inq_open_segment and inq_open_segment_and_mode leave segno unchanged and seg_open is set to FALSE (0). If a segment is open, the display mode of the segment is returned in display. This corresponds to the display mode, which is set with the display parameter of the open_segment call. If no segment is open, display is unchanged.

ERRORS

1 Graphics device is not initialized for this operation.

Museum

Related Articles