inq_invisibility_filter(3G)

NAME

inq_invisibility_filter_sizes, inq_invisibility_filter − return information about the current invisibility filter

SYNOPSIS

C Syntax:

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

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

FORTRAN77 Syntax:

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

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

Pascal Syntax:

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

procedure inq_invisibility_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 invisibility filter.

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

i_names Buffer in which the integers whose bits make up the names in the inclusion set of the invisibility filter are returned. The i_names array must be able to hold at least i_count integers.

x_names Buffer in which the integers whose bits make up the names in the exclusion set of the invisibility filter are returned. The x_names array must be able to hold at least x_count integers.

Discussion

Inq_invisibility_filter_sizes and inq_invisibility_filter return information about the current invisibility filter of the specified graphics device. The invisibility filter of a graphics device may be set by set_invisibility_filter(3G).

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

Inq_invisibility_filter returns in i_names the list of integers that make up the invisibility 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 invisibility filter are empty. This implies that by default no primitives are invisible (all are visible).

Museum

Related Articles