inq_highlighting_filter(3G)

NAME

inq_highlighting_filter_sizes, inq_highlighting_filter − return information about the current highlighting filter

SYNOPSIS

C Syntax:

void inq_highlighting_filter_sizes(fildes, i_count, x_count)
int fildes, *i_count, *x_count;

void inq_highlighting_filter(fildes, i_names, x_names)
int fildes, i_names[], x_names[];

FORTRAN77 Syntax:

subroutine inq_highlighting_filter_sizes(fildes, i_count, x_count)
integer*4 fildes, i_count, x_count

subroutine inq_highlighting_filter(fildes, i_names, x_names)
integer*4 fildes, i_names(*), x_names(*)

Pascal Syntax:

procedure inq_highlighting_filter_sizes(fildes:integer;
var i_count, x_count:integer);

procedure inq_highlighting_filter(fildes:integer;
var i_names: array[lo1..hi1] of integer;
var x_names: array[lo2..hi2] of integer);

DESCRIPTION

Input Parameters

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

Output Parameters

i_count Number of integers needed to represent the names in the inclusion set of the highlighting filter.

x_count Number of integers needed to represent the names in the exclusion set of the highlighting filter.

i_names Buffer in which the integers whose bits make up the names in the inclusion set of the highlighting filter are returned.

x_names Buffer in which the integers whose bits make up the names in the exclusion set of the highlighting filter are returned.

Discussion

Inq_highlighting_filter_sizes and inq_highlighting_filter return information about the current highlighting filter of the specified graphics device. The highlighting filter of a graphics device may be set by set_highlighting_filter(3G).

Inq_highlighting_filter_sizes sets i_count to the number of integers that make up the highlighting filter’s inclusion set, and x_count to the number of integers that make up the highlighting filter’s exclusion set. The i_names and x_names parameters passed to inq_highlighting_filter must be able to hold at least i_count and x_count integers, respectively.

Inq_highlighting_filter returns in i_names the list of integers that make up the highlighting filter’s inclusion set, and in x_names the list of names that make up the filter’s exclusion set.

ERRORS

1 Graphics device is not initialized for this operation.

DEFAULTS

When a graphics device is gopen´ed the inclusion and exclusion sets of its highlighting filter are empty. This implies that, by default, no primitive is highlighted.

Museum

Related Articles