GSLCAT(3g,L)                AIX Technical Reference                GSLCAT(3g,L)



-------------------------------------------------------------------------------
gslcat



PURPOSE

Sets the locator attributes.

C SYNTAX

int gslcat_ (hg, vg)

int *hg, *vg;

FORTRAN SYNTAX

INTEGER function gslcat (hg, vg)

INTEGER hg, vg

PASCAL SYNTAX

FUNCTION gslcat_ (

VAR hg, vg: INTEGER
): INTEGER [PUBLIC];

DESCRIPTION

The gslcat subroutine sets the locator attributes.  Its effect depends on the
type of locator attached.  For a mouse, gslcat sets the thresholds.  For a
tablet, it sets the dead zone.

Parameters

hg, vg  Define the horizontal and vertical values for the locator threshold or
        dead zone, in units of 0.25 millimeter.

The mouse thresholds determine the granularity of input events reported, or the
amount of horizontal or vertical mouse movement required before an event
occurs.

The tablet dead zone is an area of the tablet in which no event reports occur,
even if the tablet sensor is present.  This dead zone allows the application to
make the tablet aspect ratio compatible with the display and allows tablets of
different sizes to appear the same size to an application.  The dead zone acts
as a border around the tablet.  The device driver reports movement only when
the x value is greater than or equal to hg or less than or equal to (maximum
tablet value - hg), and the y value is greater than or equal to vg or less than
or equal to (maximum tablet value - vg).




Processed November 7, 1990       GSLCAT(3g,L)                                 1






GSLCAT(3g,L)                AIX Technical Reference                GSLCAT(3g,L)



An attempt to set the locator attributes may fail for a variety of reasons, the
most likely of which is that the device is not attached.  The nature of the
problem can be determined with a specific ioctl to the virtual terminal.  (See
"hft" for more information.)

Note that the gslcat subroutine allows an application to set the mouse
thresholds or the tablet dead zone such that no events occur even if the device
is enabled.

RETURN VALUE

GS_SUCC  Successful.
GS_USUC  Unsuccessful.

RELATED INFORMATION

In this book:  "hft."






































Processed November 7, 1990       GSLCAT(3g,L)                                 2