wacom(4)
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. Only simple button presses can be
configured here; for more complex actions, use
xsetwacom(1). 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 touch events for touch devices, i.e., system
cursor moves when user touches the tablet. Default to "on"
for devices that support touch; "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 "GrabDevice" "bool"
sets whether the underlying event device will be grabbed by
the driver to prevent the data from leaking to
/dev/input/mice. When enabled, while the X server is
running, no other programs will be able to read the event
stream. Default: "false".
Option "CursorProx" "number"
sets the max distance from tablet to stop reporting
movement for the cursor. 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 multi-finger in-driver gesture support on
the device. Default: off unless the tablet supports multi-
touch. Note that disabling this option may allow the
desktop environment to detect multi-finger gestures
instead.
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.
Option "PressureRecalibration" "bool"
Allows to disable pressure recalibration. Default: true.
If the initial pressure of a device is != 0 the driver
recalibrates the pressure range. This is to account for
worn out devices. The downside is that when the user hits
the tablet very hard the initial pressure reading may be
unequal to zero even for a perfectly good pen. If the
consecutive pressure readings are not higher than the
initial pressure by a threshold no button event will be
generated. This option allows to disable the
recalibration.
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 Vigerlf <Magnus.Vigerlof@ipbo.se>
Opportunity
Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.
Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.
Free Software
Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.
Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.
Free Books
The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.
Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.
Education
Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.
Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.
