1WACOM(4) Kernel Interfaces Manual WACOM(4)
2
6 wacom - Wacom input driver
7
9 Section "InputDevice"
10 Identifier "idevname"
11 Driver "wacom"
12 Option "Device" "devpath"
13 ...
14 EndSection
15
17 wacom is an X input driver for Wacom devices.
18 The wacom driver functions as a pointer input device, and may be used
20 as the X server's core pointer.
21
23 This driver supports the Wacom IV and Wacom V protocols. Serial tablets
24 only need this driver. USB tablet support is available on some Linux
25 platforms. USB tablets needs wacom kernel driver being loaded before
26 this driver starts. Please check linuxwacom.sf.net for latest updates
27 of Wacom X and kernel drivers.
28
30 Please refer to xorg.conf(5x) for general configuration details and for
31 options that can be used with all input drivers. This section only
32 covers configuration details specific to this driver.
33 Multiple instances of the Wacom devices can cohabit. It can be useful
35 to define multiple devices with different active zones. Each device
36 supports the following entries:
37 Option "Type" "stylus"|"eraser"|"cursor"|"pad"|"touch"
39 sets the type of tool the device represents. This option is
40 mandatory. The core options, such as "SendCoreEvents" or
41 "AlwaysCore", are unnecessary in Gimp if you don't need to
42 move system cursor outside of Gimp drawing area. "pad" is
43 for Intuos 3 or Cintiq 21UX tablet ExpressKeys/menu strips,
44 and Graphire 4 or Bamboo tablet buttons, wheel, and/or
45 ring. It is required for Intuos3, CintiqV5, Graphire 4,
46 and Bamboo if you want to use keystroke features. "pad" is
47 reported as a second tool in the driver. "touch" is for the
48 tablet with touch support. Right now only a few Tablet PCs
49 have this feature.
50 Option "Device" "path"
52 sets the path to the special file which represents serial
53 line where the tablet is plugged. You have to specify it
54 for each subsection with the same value if you want to have
55 multiple devices with the same tablet. This option is
56 mandatory.
57 Option "Suppress" "number"
59 sets the position increment under which not to transmit
60 coordinates. This entry must be specified only in the
61 first Wacom subsection if you have multiple devices for one
62 tablet. If you don't specify this entry, the default value,
63 which is 2, will be used. To disable suppression, the entry
64 should be specified as 0. When suppress is defined, an
65 event will be sent only when at least one of the following
66 conditions is met:
67 the change between the current X coordinate and the
69 previous one is greater than suppress;
70 the change between the current Y coordinate and the
72 previous one is greater than suppress;
73 the change between the current pressure and the
75 previous one is greater than suppress;
76 the change between the current degree of rotation
78 and the previous one of the transducer is greater than sup‐
79 press;
80 the change between the current absolute wheel value
82 and the previous one is equal to or greater than suppress;
83 the change between the current tilt value and the
85 previous one is equal to or greater than suppress (if tilt
86 is supported);
87 relative wheel value has changed;
89 button value has changed;
91 proximity has changed.
93 Option "Mode" "Relative"|"Absolute"
95 sets the mode of the device. The default value for stylus,
96 pad and eraser is Absolute; cursor is Relative; touch
97 defaults to Relative for tablets with touch pads and Abso‐
98 lute for touch screens.
99 Option "TopX" "number"
101 X coordinate of the top corner of the active zone. Default
102 to 0.
103 Option "TopY" "number"
105 Y coordinate of the top corner of the active zone. Default
106 to 0.
107 Option "BottomX" "number"
109 X coordinate of the bottom corner of the active zone.
110 Default to width of the tablet.
111 Option "BottomY" "number"
113 Y coordinate of the bottom corner of the active zone.
114 Default to height of the tablet.
115 Option "ButtonsOnly" "on"|"off"
117 disables the device's motion events. Default to off.
118 Option "ButtonM" "AC"
120 reports an action AC when button M is pressed, where M is
121 one of the device supported button numbers, it can be 1
122 to 32. Wacom uses a driver-internal button mapping, where
123 any physical button appears to the X server as the button
124 specified by the ButtonM mapping. Hence, if two physical
125 buttons have the same ButtonM mapping, the server will
126 think they are the same physical button. The default
127 action reported to the X server is mouse button M click.
128 Because X uses buttons 4, 5, 6, and 7 as the four scrolling
129 directions, physical buttons 4 and higher are mapped to 8
130 and higher by default. To ignore the button click, i.e.,
131 to not report any button click event to the X server, use
132 "0" or "button 0".
133 Option "TPCButton" "on"|"off"
135 enables the stylus buttons as Tablet PC buttons, i.e.,
136 reports stylus button event only when its tip is pressed.
137 Default to "on" for Tablet PCs; "off" for all other models.
138 Option "Touch" "on"|"off"
140 enables the touch event for Tablet PC that supports touch
141 feature, i.e., system cursor moves when user touches the
142 tablet. Default to "on" for Tablet PCs with touch feature;
143 "off" for all other models.
144 Option "Capacity" "number"
146 sets touch sensitivity level for capacitive touch device,
147 where number can be an integer from -1 to 5. Default is 3
148 for capacitive tools and -1 for none capacitive tools.
149 Option "Speed" "Rspeed"
151 sets the cursor's relative movement speed to Rspeed. The
152 default value is 1.0. A Rspeed greater than 1.0 will speed
153 up the cursor's relative movement. A Rspeed less than 1.0
154 but greater than 0 will slow down the cursor's relative
155 movement. A Rspeed too close to 0 is not recommanded.
156 Option "Twinview" "horizontal"|"verti‐
158 cal"|"leftof"|"aboveof"|"xinerama"|"none"
159 sets the orientation of TwinView to map the tablet to one
160 screen and to be able to move the screen cursor from one
161 screen to the other when tool reaches the edge of the
162 tablet. The cursor can be constrained in a specific screen
163 if "ScreenNo" option is added. If you want to map the
164 tablet to the whole desktop, you should NOT add this
165 option. The default is "none". Note: due to historic rea‐
166 son, "horizontal" represents the "RightOf" and "vertical"
167 represents the "BelowOf" in acutal TwinView setup.
168 Option "TVResolution" "res0,res1"
170 specifies different resolutions for the two screens in
171 TwinView setup. For example, if the resolution of screen 0
172 (res0) is 1024x768 and screen 1 (res1) is 1280x1024, the
173 option will be set to:
174 Option "TVResolution" "1024x768,1280x1024"
175 This option is used only when TwinView option is not none.
177 It is unnecessary to add this option if your screens are
178 displaying in the same resolutions.
179 Option "ScreenNo" "n"
181 In a multi-monitor environment, specifies the screen number
182 in which the cursor can move.
183 Option "MMonitor" "n"
185 turns on/off across monitor movement on a non-TwinView
186 multi-monitor desktop. The default is "on". Here n starts
187 from 0, which indicates the first screen.
188 Option "Rotate" "CW"|"CCW"|"HALF"|"NONE"
190 rotates the tablet orientation counterclockwise (CCW) or
191 clockwise (CW) or 180 degrees (HALF). If you have specific
192 tablet mappings, i.e. TopX/Y or BottomX/Y were set, the
193 mapping will be applied before rotation. The default is
194 "NONE".
195 Option "PressCurve" "x1,y1,x2,y2"
197 sets pressure curve by control points x1, y1, x2, and y2.
198 Their values are in range from 0..100. The pressure curve
199 is interpreted as Bezier curve with 4 control points, the
200 first and the last control point being fixed on the coordi‐
201 nates 0/0 and 100/100, respectively. The middle control
202 points are adjustible by this setting and thus define the
203 shape of the curve. The input for linear curve (default)
204 is "0,0,100,100"; slightly depressed curve (firmer) might
205 be "5,0,100,95"; slightly raised curve (softer) might be
206 "0,5,95,100". The pressure curve is only applicable to
207 devices of type stylus or eraser, other devices do not
208 honor this setting.
209 Option "KeepShape" "on"|"off"
212 When this option is enabled, the active zone begins
213 according to TopX and TopY. The bottom corner is adjusted
214 to keep the ratio width/height of the active zone the same
215 as the screen while maximizing the area described by TopX,
216 TopY, BottomX, BottomY.
217 Option "DebugLevel" "number"
219 sets the level of debugging info reported. There are 12
220 levels, specified by the integers between 1 and 12. Once
221 it is defined, all the debug messages with a level less
222 than or equal to the "number" will be logged into
223 /etc/X11/Xorg.0.log.
224 Option "CommonDBG" "number"
226 sets the level of debugging info for all devices defined
227 for the same tablet. There are 12 levels in use, specified
228 by the integers between 1 and 12. Once it is defined, all
229 the debug messages with a level less than or equal to the
230 "number" will be logged into /etc/X11/Xorg.0.log.
231 Option "CursorProx" "number"
233 sets the max distance from tablet to stop reporting move‐
234 ment for cursor in relative mode. Default for Intuos
235 series is 10, for Graphire series (including Volitos) is
236 42.
237 Option "Serial" "number"
239 sets the serial number associated with the physical device.
240 This allows to have multiple devices of the same type (i.e.
241 multiple pens). This option is only available on wacom V
242 devices (Intuos series and Cintiq 21U). To see which
243 serial number belongs to a device, you need to run the
244 utility program, xsetwacom, which comes with linuxwacom
245 package.
246 Option "Threshold" "number"
248 sets the pressure threshold used to generate a button 1
249 events of stylus. The default is MaxPressure*3/50.
250
252 Xorg(1x), xorg.conf(5x), xorgconfig(1x), Xserver(1x), X(7).
253
255 Frederic Lepied <lepied@xfree86.org>, Ping Cheng <pingc@wacom.com>,
256 John E. Joganic <jej@j-arkadia.com>, Magnus Vigerlöf <Mag‐
257 nus.Vigerlof@ipbo.se>, Peter Hutterer <peter.hutterer@who-t.net>
258X Version 11 xf86-input-wacom 0.10.8 WACOM(4)