Provided by: xserver-xorg-input-wacom_0.8.2.2-0ubuntu2_i386 bug

NAME

       wacom - Wacom input driver

SYNOPSIS

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

DESCRIPTION

       wacom is an X input driver for Wacom devices.

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

SUPPORTED HARDWARE

       This driver supports the Wacom IV and Wacom V protocols. Serial tablets
       only  need  this driver.  USB tablet support is available on some Linux
       platforms.  USB tablets needs wacom kernel driver being  loaded  before
       this  driver starts.  Please check linuxwacom.sf.net for latest updates
       of Wacom X and kernel drivers.

CONFIGURATION DETAILS

       Please refer to xorg.conf(5x) 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 Wacom 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"|"pad"|"touch"
                   sets the type of tool the device represents. This option is
                   mandatory.   The  core options, such as "SendCoreEvents" or
                   "AlwaysCore", are unnecessary in Gimp if you don’t need  to
                   move  system cursor outside of Gimp drawing area.  "pad" is
                   for Intuos 3 or Cintiq 21UX tablet ExpressKeys/menu strips,
                   and  Graphire  4  or  Bamboo  tablet buttons, wheel, and/or
                   ring.  It is required  for Intuos3,  CintiqV5, Graphire  4,
                   and Bamboo if you want to use keystroke features.  "pad" is
                   reported as a second tool in the driver. "touch" is for the
                   tablet with touch support.  Right now only a few Tablet PCs
                   have this feature.

               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"
                   tells the driver to dialog with the  tablet  the  USB  way.
                   This option is mandatory for USB tablets.

               Option "ForceDevice" "ISDV4"
                   tells  the  driver  to  dialog  with  the tablet the serial
                   Tablet PC way.  It is a special Wacom IV  protocol,  called
                   ISDV4 protocol.  This option is mandatory for serial Tablet
                   PCs only.

               Option "Suppress" "Inumber"
                   sets the position increment under  which  not  to  transmit
                   coordinates.   This  entry  must  be  specified only in the
                   first Wacom subsection if you have multiple devices for one
                   tablet. If you don’t specify this entry, the default value,
                   which is 2, will be used. To disable suppression, the entry
                   should  be  specified  as 0.  When suppress is defined,  an
                   event will be sent only when at least one of the  following
                   conditions is met:

                           the change between the current X coordinate and the
                   previous one is greater than suppress;

                           the change between the current Y coordinate and the
                   previous one is greater than suppress;

                           the  change  between  the  current pressure and the
                   previous one is greater than suppress;

                           the change between the  current degree of  rotation
                   and  the  previous  one  of  the transducer is greater than
                   suppress;

                           the change between the current absolute wheel value
                   and the previous one is equal to or greater than suppress;

                           the  change  between the current tilt value and the
                   previous one is equal to or greater than suppress (if  tilt
                   is supported);

                           relative wheel value has changed;

                           button value has changed;

                           proximity has changed.

               Option "Mode" "Relative"|"Absolute"
                   sets  the mode of the device.  The default value for stylus
                   and eraser is Absolute; cursor is  Relative;  pad  mode  is
                   decided  according  to its core option due to its nature of
                   not moving system cursor: Relative if it is a core  device;
                   Absolute, otherwise; touch is always in absolute mode.

               Option "TopX" "number"
                   X coordinate of the top corner of the active zone.  Default
                   to 0.

               Option "TopY" "number"
                   Y coordinate of the top corner of the active zone.  Default
                   to 0.

               Option "BottomX" "Inumber"
                   X  coordinate  of  the  bottom  corner  of the active zone.
                   Default to width of the tablet.

               Option "BottomY" "number"
                   Y coordinate of the  bottom  corner  of  the  active  zone.
                   Default to height of the tablet.

               Option "ButtonsOnly" "on"|"off"
                   disables the device’s motion events.  Default to off.

               Option "ButtonM" "AC"
                   reports  an action AC when button M is pressed,  where M is
                   one of the device supported  button numbers,  it can  be  1
                   to  32.  The  default  action  reported  to Xinput is mouse
                   button M click.  To ignore the button click, i.e.,  to  not
                   report  any  button  click  event  to  Xinput,   use "0" or
                   "button 0".

               Option "TPCButton" "on"|"off"
                   enables the stylus buttons as  Tablet  PC  buttons,   i.e.,
                   reports  stylus  button event only when its tip is pressed.
                   Default to "on" for Tablet PCs; "off" for all other models.

               Option "Touch" "on"|"off"
                   enables  the  touch event for Tablet PC that supports touch
                   feature,  i.e., system cursor moves when user  touches  the
                   tablet.  Default to "on" for Tablet PCs with touch feature;
                   "off" for all other models.

               Option "Capacity" "number"
                   sets touch sensitivity level for capacitive  touch  device,
                   where  number can be an integer from -1 to 5.  Default is 3
                   for capacitive tools and -1 for none capacitive tools.

               Option "Speed" "Rspeed"
                   sets the cursor’s relative movement speed to  Rspeed.   The
                   default value is 1.0.  A Rspeed greater than 1.0 will speed
                   up the cursor’s relative movement.  A Rspeed less than  1.0
                   but  greater  than  0  will slow down the cursor’s relative
                   movement.  A Rspeed too close to 0 is not recommanded.

               Option "Twinview" "horizontal"|"vertical"|"none"
                   sets the orientation of TwinView to map the tablet  to  one
                   screen  and  to  be able to move the screen cursor from one
                   screen to the other when  tool  reaches  the  edge  of  the
                   tablet.  The cursor can be constrained in a specific screen
                   if "ScreenNo" option is added.  If you   want  to  map  the
                   tablet  to  the  whole  desktop,  you  should  NOT add this
                   option.  The default is "none".

               Option "TVResolution" "res1,res2"
                   specifies different resolutions  for  the  two  screens  in
                   TwinView setup.  For example, if the resolution of screen 1
                   (res1) is 1024x768 and screen 2 (res2)  is  1280x1024,  the
                   option will be set to:
                               Option "TVResolution" "1024x768,1280x1024"

                   This  option is used only when TwinView option is not none.
                   It is unnecessary to add this option if  your  screens  are
                   displaying in the same resolutions.

               Option "ScreenNo" "n"
                   In a multi-monitor environment, specifies the screen number
                   in which the cursor can move.

               Option "MMonitor" "n"
                   turns on/off across  monitor  movement  on  a  non-TwinView
                   multi-monitor desktop. The default is "on".

               Option "Rotate" "CW"|"CCW"|"HALF"|"NONE"
                   rotates  the  tablet  orientation  clockwise (CCW) or anti-
                   clockwise (CW)  or  180  degrees  (HALF).  The  default  is
                   "NONE".

               Option "PressCurve" "x1,y1,x2,y2"
                   sets  pressure  curve by control points x1, y1, x2, and y2.
                   Their values are  in  range  from  0..100.  The  input  for
                        linear curve (default) is "0,0,100,100";      slightly
                   depressed   curve   (firmer)   might    be    "5,0,100,95";
                        slightly  raised curve (softer) might be "0,5,95,100".

               Option "KeepShape" "on"|"off"
                   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 TopX,
                   TopY, BottomX, BottomY.

               Option "DebugLevel" "number"
                   sets the level of debugging info reported.   There  are  12
                   levels,  specified  by the integers between 1 and 12.  Once
                   it is defined, all the debug messages  with  a  level  less
                   than   or  equal  to  the  "number"  will  be  logged  into
                   /etc/X11/Xorg.0.log.

               Option "CommonDBG" "number"
                   sets the level of debugging info for  all  devices  defined
                   for  the same tablet. There are 12 levels in use, specified
                   by the integers between 1 and 12. Once it is  defined,  all
                   the  debug  messages with a level less than or equal to the
                   "number" will be logged into /etc/X11/Xorg.0.log.

               Option "CursorProx" "number"
                   sets  the  max  distance  from  tablet  to  stop  reporting
                   movement  for  cursor  in relative mode. Default for Intuos
                   series is 10, for Graphire series  (including  Volitos)  is
                   42.

               Option "Serial" "number"
                   sets the serial number associated with the physical device.
                   This allows to have multiple devices of the same type (i.e.
                   multiple  pens).  This  option is only available on wacom V
                   devices (Intuos series  and  Cintiq  21U).   To  see  which
                   serial  number  belongs  to  a  device, you need to run the
                   utility program, xsetwacom,  which  comes  with  linuxwacom
                   package.

               Option "Threshold" "number"
                   sets  the  pressure  threshold  used to generate a button 1
                   events of stylus.  The default is MaxPressure*3/50.

SEE ALSO

       Xorg(1x), xorg.conf(5x), xorgconfig(1x), Xserver(1x), X(7).

AUTHORS

       Frederic Lepied <lepied@xfree86.org> Ping Cheng <pingc@wacom.com>  John
       E.        Joganic       <jej@j-arkadia.com>       Magnus       Vigerlöf
       <Magnus.Vigerlof@ipbo.se>