Provided by: xserver-xorg-input-wacom_0.14.0-0ubuntu2_amd64 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.sourceforge.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.

       Match directives are applied by the X server before the driver is selected.  The type name
       of  the  parent device is appended by the driver. It is not possible to use a MatchProduct
       directive to match against this appended type name.

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 "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 in-
                   driver hotplugged devices (see DRIVER-INTERNAL DEVICE HOTPLUGGING  )  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 "RawSample" "number"
                   Set   the   sample   window   size  (a  sliding  average  sampling window) for
                   incoming input tool raw data points.  Default:  4, range of 1 to 20.

               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 "ToolSerials" "number[,type[,label]][;...]"
                   sets the list of serial numbered devices that need  to  be  hotplugged  for  a
                   physical  device. The 'type' option may be any of "pen", "airbrush", "artpen",
                   or "cursor".  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, that comes with this driver.

               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.

               Option "Gesture" "bool"
                   Enable or disable gesture support on  the  device.  Default:  off  unless  the
                   tablet supports multi-touch.

               Option "ZoomDistance" "number"
                   If  Option  "Gesture"  is  enabled, this option specifies the minimum movement
                   distance before a zoom gesture is recognized.

               Option "ScrollDistance" "number"
                   If Option "Gesture" is enabled, this option  specifies  the  minimum  movement
                   distance before a scroll gesture is recognized.

               Option "TapTime" "number"
                   If  Option  "Gesture" is enabled, this option determines the maximum time of a
                   touch event to be recognized as tap. A press and release  event  shorter  than
                   TapTime generates button press and release events. Presses longer than TapTime
                   do not generate button events, only motion events.

TOUCH GESTURES

   Single finger (1FG)
       Left click: tap, actual click happens after TapTime period elapses.

       Left click drag: tap to select, quickly (within TapTime  period)  touch  selection  again.
       Then drag.  Available on touchpads, e.g. BambooPT, not touchscreens.

   Two finger (2FG)
       Right click: one finger down + tap second finger

       Vertical  scroll:  two  fingers  side  by side (in any orientation) moving vertically with
       constant separation initiates a vertical scroll.  By driver default a gesture  up  results
       in  a  scroll down event (the document moves up) and a gesture down results in a scroll up
       event (moving the document down).

       Horizontal  scroll:  two  fingers  side  by  side  held  at  a  constant  distance  moving
       horizontally  initiates  a  horizontal  scroll.  A gesture to the left results in a scroll
       right event (the document moves left) and a gesture right results in a scroll  left  event
       (moving the document right).

       Zoom in: two separated fingers side by side, bring together i.e. pinch.

       Zoom out: two fingers side by side, spread.  Not all applications support zoom.

SEE ALSO

       Xorg(1), xorg.conf(5), xorg.conf.d(5), X(7)

       More information is available at http://linuxwacom.sourceforge.net

AUTHORS

       Peter  Hutterer  <peter.hutterer@who-t.net>, Ping Cheng <pingc@wacom.com>, Frederic Lepied
       <lepied@xfree86.org>,   John   E.    Joganic    <jej@j-arkadia.com>,    Magnus    Vigerlöf
       <Magnus.Vigerlof@ipbo.se>