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



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

Parameter

results           Contains, on return, information about the type of locator,
                  the resolution of the locator device, the maximum horizontal
                  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.









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

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



Entry    Description

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 following bits is ignored.
         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.


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











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