pick_window(3G)

NAME

inq_pick_window, intinquire_pick_window, set_pick_window, intset_pick_window − define pick window for pick_from_segment and hit_mode

SYNOPSIS

C Syntax:

void inq_pick_window ( fildes, px_min, py_min, px_max, py_max )
int fildes;
float *px_min, *py_min, *px_max, *py_max;

void intinquire_pick_window ( fildes, px_min, py_min, px_max,
py_max )
int fildes, *px_min, *py_min, *px_max, *py_max;

void set_pick_window ( fildes, px_min, py_min, px_max, py_max )
int fildes;
float px_min, py_min, px_max, py_max;

void intset_pick_window ( fildes, px_min, py_min, px_max, py_max )
int fildes, px_min, py_min, px_max, py_max;

FORTRAN77 Syntax:

subroutine inq_pick_window ( fildes, px_min, py_min, px_max,
py_max )
integer*4 fildes
real px_min, py_min, px_max, py_max

subroutine intinquire_pick_window ( fildes, px_min, py_min,
px_max, py_max )
integer*4 fildes, px_min, py_min, px_max, py_max

subroutine set_pick_window ( fildes, px_min, py_min, px_max,
py_max )
integer*4 fildes
real px_min, py_min, px_max, py_max

subroutine intset_pick_window ( fildes, px_min, py_min, px_max,
py_max )
integer*4 fildes, px_min, py_min, px_max, py_max

Pascal Syntax:

procedure inq_pick_window ( fildes:integer; var px_min, py_min,
px_max, py_max:real );

procedure intinquire_pick_window ( fildes:integer; var px_min,
py_min, px_max, py_max:integer );

procedure set_pick_window ( fildes:integer; px_min, py_min, px_max,
py_max:real );

procedure intset_pick_window ( fildes, px_min, py_min, px_max,
py_max:integer );

DESCRIPTION

Input Parameters

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

px_min Minimum x limit for pick window in VDC units.

py_min Minimum y limit for pick window in VDC units.

px_max Maximum x limit for pick window in VDC units.

py_max Maximum y limit for pick window in VDC units.

Discussion

Set_pick_window and intset_pick_window set a 2-dimensional rectangular window which together with pick_depth defines a pick aperture.

Inq_pick_window and intinquire_pick_window returns the current set values for the pick window.

The pick window is used for hit testing when the Starbase hit mode is enabled (see hit_mode(3G)). Hit testing is also done by pick_from_segment.

Note that some picking modes (see set_pick_mode(3G) in the Starbase Display List Programmers Manual may cause pick_from_segment(3G) to alter the pick window.

Integer operations are only available when using the INT_XFORM gopen mode. When in INT_XFORM mode, floating point operations are not available for that fildes. Floating point operations are the default, or can be specified with FLOAT_XFORM mode. For a list of integer operations, floating point operations and common operations see the starbase(3G) manual page.

ERRORS

1 Graphics device is not initialized for this operation.

DEFAULTS

Float: (px_min, py_min, px_max, py_max)=(0.0, 0.0, 1.0, 1.0)
Integer: (px_min, py_min, px_max, py_max)=(0, 0, 32767, 32767)

Museum

Related Articles