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).

     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."