Man Linux: Main Page and Category List

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 "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,   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"|"leftof"|"aboveof"|"xinerama"|"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".  Note:  due  to  historic
                   reason,   "horizontal"    represents   the   "RightOf"  and
                   "vertical" represents  the  "BelowOf"  in  acutal  TwinView
                   setup.

               Option "TVResolution" "res0,res1"
                   specifies  different  resolutions  for  the  two screens in
                   TwinView setup.  For example, if the resolution of screen 0
                   (res0)  is  1024x768  and screen 1 (res1) 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". Here n  starts
                   from  0, which indicates the first screen.

               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.  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 "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     Vigerlf
       <Magnus.Vigerlof@ipbo.se>, Peter Hutterer <peter.hutterer@who-t.net>