inq_pick_filter(3G)

NAME

inq_pick_filter_sizes, inq_pick_filter − return information about the current pick filter

SYNOPSIS

C Syntax:

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

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

FORTRAN77 Syntax:

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

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

Pascal Syntax:

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

procedure inq_pick_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 pick filter.

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

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

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

Discussion

Inq_pick_filter_sizes and inq_pick_filter return information about the current pick filter of the specified graphics device. The pick filter of a graphics device is set by set_pick_filter(3G).

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

Inq_pick_filter returns in i_names the list of integers that make up the pick 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 pick filter are empty and the pick sense is normal. This implies that by default every primitive is pickable.

Museum

Related Articles