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>