gsqlext

Purpose

     Returns expanded information about the locator.

C Syntax

     int gsqlext_ (results )

     int results[16|;

FORTRAN Syntax

     INTEGER function gsqlext (results)

     INTEGER results (16 )

Pascal Syntax

     FUNCTION gsqlext_ (

     VAR results: ARRAY[1..16| of INTEGER;
     ): INTEGER [PUBLIC|;

Description

     The  gsqlext  subroutine   returns  an  array  containing
     expanded information about the locator device.

     Parameters

     results           Contains, on  return, information about
                       the type of locator, the resolution  of
                       the locator  device, the  maximum hori-
                       zontal  and  vertical counts,  and  the
                       current setting of  the relative device
                       thresholds or the  absolute device dead
                       zone   values.   The   following  table
                       describes the information in the array.

                    Entry  Description

                    0      Locator resolution in millimeters per 100 counts.

                    1      Indicates the  locator device  type.  If  the most
                           significant bit is:

                           0    The  locator  type  is  a  mouse.   When  the
                                locator is  a mouse, the setting  of the fol-
                                lowing bits is ignored.
                           1    The locator type is  a tablet.  For a tablet,

                         00e nSe01orsAystylusuiseattached.noesensor is
                              at10cheA.four-button puck is attached.

                    2      Maximum horizontal count.

                    3      Maximum vertical count.

                    4      The horizontal  locator threshold or dead  zone in
                           units of 0.25 millimeter.

                    5      The  vertical locator  threshold or  dead zone  in
                           units of 0.25 millimeter.

                    6-15   Reserved.

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

     For Pascal, the application must declare the array passed
     as  being  fixed  length   and  declare  the  routine  as
     accepting an array of that  length.  The k in the routine
     declaration must be a constant.

Return Value

     GS_SUCC   Successful.
     GS_USUC   Unsuccessful.

Related Information

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