Provided by: xserver-xorg-input-wacom_0.11.0-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.

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 and requires the wacom kernel driver being loaded before this
       driver  starts.   Please  check  http://linuxwacom.sf.net  for   latest
       updates of Wacom X and kernel drivers.

DRIVER-INTERNAL DEVICE HOTPLUGGING

       When  input  device  hotplugging  in  the  X  server  is enabled and no
       InputDevice section exists  for  a  compatible  tablet  device  and  an
       InputClass  section  (see  xorg.conf.d(5x)) assigns this driver for the
       device, the wacom driver creates multiple X devices for each a physical
       device,  one  X  device  for  each available tool. The list of tools is
       hardware-dependent. See Option Type as outlined  in  the  CONFIGURATION
       DETAILS section.

       These  tool-specific  devices  are  referred  to  as  parent device and
       dependent device.  The parent device is the one presented by the system
       and  the  one  that  causes the X server to load the wacom driver. This
       parent device then causes the automatic addition of  several  dependent
       devices.  If  the  parent device is unplugged or otherwise removed, the
       dependent devices will be automatically removed as well.

       Dependent  devices  may  be  assigned  tool-specific  options   through
       additional  InputClass  sections. We recommend that a MatchDriver wacom
       line is used  in  these  sections  in  addition  to  the  user-specific
       pattern.

CONFIGURATION DETAILS

       Please   refer   to   xorg.conf(5x)   or  xorg.conf.d(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.  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 "Suppress" "number"
                   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,
                   pad  and  eraser  is  Absolute;  cursor  is Relative; touch
                   defaults to  Relative  for  tablets  with  touch  pads  and
                   Absolute for touch screens.

               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" "number"
                   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.  Wacom uses a driver-internal button mapping, where
                   any physical button appears to the X server as  the  button
                   specified  by  the  ButtonM mapping. Hence, if two physical
                   buttons have the same  ButtonM  mapping,  the  server  will
                   think  they  are  the  same  physical  button.  The default
                   action reported to the X server is mouse  button  M  click.
                   Because X uses buttons 4, 5, 6, and 7 as the four scrolling
                   directions, physical buttons 4 and higher are mapped  to  8
                   and  higher  by default.  To ignore the button click, i.e.,
                   to not report any button click event to the X server,   use
                   "0" or "button 0".

               Option "TPCButton" "on"|"off"
                   enables  the  stylus  buttons  as  Tablet  PC  buttons.  If
                   enabled, the stylus reports button events only when its tip
                   is pressed. If any button is down, pressing the tip reports
                   a button event for the button. Otherwise if  no  button  is
                   down, the tip reports as usual.  Default to "on" for Tablet
                   PCs; "off" for all other  models.  Only  available  on  the
                   stylus tool.

               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 non-capacitive tools.

               Option "Rotate" "CW"|"CCW"|"HALF"|"NONE"
                   rotates the tablet orientation  counterclockwise  (CCW)  or
                   clockwise (CW) or 180 degrees (HALF).  If you have specific
                   tablet mappings, i.e. TopX/Y or  BottomX/Y  were  set,  the
                   mapping  will  be applied before rotation. Rotation must be
                   applied to the parent device (usually the stylus), rotation
                   settings on hotplugged devices will be ignored. 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 pressure curve
                   is interpreted as Bezier curve with 4 control  points,  the
                   first  and  the  last  control  point  being  fixed  on the
                   coordinates  0/0  and  100/100,  respectively.  The  middle
                   control  points  are  adjustible  by  this setting and thus
                   define the shape of the curve.  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".  The pressure curve is only
                   applicable to devices  of  type  stylus  or  eraser,  other
                   devices do not honor this setting.

               Option "DebugLevel" "number"
                   sets   the   level  of  debugging  info  for  tool-specific
                   messages.  There are 12 levels, specified by  the  integers
                   between  1  and  12.   All debug messages with a level less
                   than or equal to the "number" will be logged into the  Xorg
                   log  file.  This option is only available if the driver was
                   built with debugging support.

               Option "CommonDBG" "number"
                   sets the level of debugging info for common (i.e. not tool-
                   specific)  code  paths  on the tablet. There are 12 levels,
                   specified by the integers  between  1  and  12.  All  debug
                   messages  with  a  level less than or equal to the "number"
                   will be logged into the Xorg log file. This option is  only
                   available if the driver was built with debugging support.

               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. Only available for the cursor/puck device.

               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 threshold applies to the normalised
                   pressure range of [0..2048].  The default is 27.

SEE ALSO

       Xorg(1x), xorg.conf(5x), xorg.conf.d(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     Vigerlof
       <Magnus.Vigerlof@ipbo.se>, Peter Hutterer <peter.hutterer@who-t.net>