gsqloc

Purpose

     Returns information about the locator.

C Syntax

     void gsqloc_ (loc_type, x_res, y_res, hg, vg)

     int *loc_type, *x_res, *y_res, *hg, *vg;

FORTRAN Syntax

     subroutine gsqloc (loc_type, resolution, hg, vg)

     INTEGER loc_type, resolution, hg, vg

Pascal Syntax

     PROCEDURE gsqloc_ (

     VAR loc_type, resolution, hg, vg: INTEGER
     ): INTEGER [PUBLIC|;

Description

     The gsqloc  subroutine returns  the type of  the locator,
     the resolution of the device,  and the current setting of
     the  relative device  thresholds or  the absolute  device
     dead zone values (see "gslcat").

     Parameters

     loc_type          Indicates the type  of locator.  If the
                       most significant bit  of loc_type is 0,
                       the  locator  is  a mouse.    When  the
                       locator is a mouse,  the setting of the
                       following  bits is  ignored.  When  the
                       most significant bit  is 1, the locator
                       type is  a tablet.   For a  tablet, the
                       next most significant 2 bits are:

                       00   Sensor  type  is undefined  or  no
                            sensor is attached.
                       01   A stylus is attached.
                       10   A four-button puck is attached.

     x_res, y_res      Indicate  the  horizontal and  vertical
                       resolution of the device in millimeters
                       per 100 counts.

     hg, vg            Define  the   horizontal  and  vertical
                       values  for  the locator  threshold  or
                       dead zone in units of 0.25 millimeters.
                       (See "gslcat.")

     An attempt to  get the locator attributes can  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
     found via a specific ioctl to the virtual terminal.  (See
     "hft" for more information.)

Return Value

     GS_SUCC   Successful.
     GS_UNSC   Unsuccessful.

Related Information

     In this book:  "hft" and "gslcat."