Provided by: xserver-xorg-input-aiptek_1.3.0-1_i386 bug

NAME

       aiptek - Aiptek USB Digital Tablet Input Driver for Linux

SYNOPSIS

       Section "InputDevice"
         Identifier "idevname"
         Driver "aiptek"
         Option "Device"   "devpath"
         ...
       EndSection

DESCRIPTION

       aiptek  is  an  Xorg  input driver for Aiptek HyperPen USB-based tablet
       devices.  This driver only supports the USB protocol,  and  only  under
       Linux; for RS-232C-based HyperPens, please see the "hyperpen" driver.

       The  aiptek driver functions as a pointer input device, and may be used
       as the X server’s core pointer.

SUPPORTED HARDWARE

       This driver supports the Aiptek HyperPen 4000U, 5000U, 6000U, 8000U and
       12000U USB-based input tablet on some Linux platforms.

CONFIGURATION DETAILS

       Please  refer to xorg.conf(5) for general configuration details and for
       options that can be used with all input  drivers.   This  section  only
       covers configuration details specific to this driver.

       Multiple  instances of the Aiptek devices can cohabit. It can be useful
       to define multiple devices with different  active  zones.  Each  device
       supports the following entries:

               Option "Type" "stylus"|"eraser"|"cursor"
                   sets  the type of tool the device represent. This option is
                   mandatory.

               Option "Device" "path"
                   sets the path to the special file which  represents  serial
                   line  where  the tablet is plugged.  You have to specify it
                   for each subsection with the same value if you want to have
                   multiple  devices  with  the  same  tablet.  This option is
                   mandatory.

               Option "USB" "on"
                   specifies that you are using the  USB  bus  to  communicate
                   with your tablet.  This setting is mandatory, as USB is the
                   only protocol supported by this driver.

               Option "DeviceName" "name"
                   sets the name of the X device.

               Option "Mode" "Relative"|"Absolute"
                   sets the mode of the device.

               Option "HistorySize" "number"
                   sets the motion history size. By default the value is zero.

               Option "AlwaysCore" "on"
                   enables  the sharing of the core pointer. When this feature
                   is enabled, the  device  will  take  control  of  the  core
                   pointer  (and  thus  will emit core events) and at the same
                   time will be  able,  when  asked  so,  to  report  extended
                   events.  You can use the last available integer feedback to
                   control this feature. When the value  of  the  feedback  is
                   zero,  the  feature is disabled. The feature is enabled for
                   any other value.

               Option "XTop" "number"
                   First of three sets of parameters to set the  active  zone.
                   This  sets the X coordinate of the top corner of the active
                   zone. "TopX" is a synonym.

               Option "YTop" "number"
                   First of three sets of parameters to set the  active  zone.
                   This  sets the Y coordinate of the top corner of the active
                   zone. "TopY" is a synonym.

               Option "XBottom" "Inumber"
                   First of three sets of parameters to set the  active  zone.
                   This  sets  the  X  coordinate  of the bottom corner of the
                   active zone. "BottomX" is a synonym.

               Option "YBottom" "number"
                   First of three sets of parameters to set the  active  zone.
                   This  sets  the  Y  coordinate  of the bottom corner of the
                   active zone. "BottomY" is a synonym.

               Option "XMax" "number"
                   Second of three sets of parameters to set the active  zone.
                   This  sets the the X coordinate of the bottom corner of the
                   active zone. The Top X corner’s coordinate is fixed  at  0.
                   "MaxX" is a synonym.

               Option "YMax" "number"
                   Second  of three sets of parameters to set the active zone.
                   This sets the the Y coordinate of the bottom corner of  the
                   active  zone.  The Top Y corner’s coordinate is fixed at 0.
                   "MaxY" is a synonym.

               Option "XOffset" "number"
                   Third of three sets of parameters to set the  active  zone.
                   This  sets the X coordinate of the top corner of the active
                   zone. "OffsetX" is a synonym.

               Option "YOffset" "number"
                   Third of three sets of parameters to set the  active  zone.
                   This  sets the Y coordinate of the top corner of the active
                   zone. "OffsetY" is a synonym.

               Option "XSize" "number"
                   Third of three sets of parameters to set the  active  zone.
                   This  sets  the  X  coordinate  of the bottom corner of the
                   active zone. Unlike others, this parameter is expressed  in
                   relative  coordinates from the "XOffset" parameter. "XSize"
                   is a synonym.

               Option "YSize" "number"
                   Third of three sets of parameters to set the  active  zone.
                   This  sets  the  Y  coordinate  of the bottom corner of the
                   active zone. Unlike others, this parameter is expressed  in
                   relative  coordinates from the "YOffset" parameter. "YSize"
                   is a synonym.

               Option "ZMin" "number"
                   Minimum pressure reading that will  be  accepted  from  the
                   Stylus tool. "MinZ" is a synonym.

               Option "ZMax" "number"
                   Maximum  pressure  reading  that  will be accepted from the
                   Stylus tool. "MaxZ" is a synonym.

               Option "XThreshold" "number"
                   Minimal change  in  X  coordinate  position  that  will  be
                   accepted as data input.  "ThresholdX" is a synonym.

               Option "YThreshold" "number"
                   Minimal  change  in  Y  coordinate  position  that  will be
                   accepted as data input.  "ThresholdY" is a synonym.

               Option "ZThreshold" "number"
                   Minimal change in pressure reading that will be accepted as
                   data input.  "ThresholdZ" is a synonym.

               Option "InvX" "on"
                   Inverts X coordinate reports. "XInv" is a synonym.

               Option "InvY" "on"
                   Inverts Y coordinate reports. "YInv" is a synonym.

               Option "Pressure" "soft"|"hard"|"linear"
                   Pressure  reports  either delivered in linearly incremental
                   values (default), or perturbed by  one  of  two  log-linear
                   algorithms ("soft" or "hard".)

               Option "KeepShape" "on"
                   When  this  option  is  enabled,  the  active  zone  begins
                   according to TopX and TopY.  The bottom corner is  adjusted
                   to  keep the ratio width/height of the active zone the same
                   as the screen while maximizing the area  described  by  the
                   active  area  set of parameters, XTop/YTop/XBottom/YBottom,
                   XMax/YMax, or XOffset/YOffset/XSize/YSize.

               Option "DebugLevel" number
                   sets the level of debugging info reported.

       This driver is currently Linux specific.

SEE ALSO

       Xorg(1), xorg.conf(5), Xserver(1), X(7), hyperpen(4).

AUTHORS

       Bryan W. Headley <bheadley@earthlink.net>

PROJECT PAGE

       http://aiptektablet.sourceforge.net tracks ongoing development of  this
       driver,  the  Linux kernel driver, and a GUI front-end application that
       works in concert with the above.