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"
39 sets the type of tool the device represents. This option is
40 mandatory. "pad" is for Intuos 3, Cintiq 21UX, or Graphire
41 4 ExpressKeys only. It is required for Intuos 3, Cintiq
42 21UX, or Graphire 4 if your application supports
43 ExpressKeys features. "pad" is reported as a second tool
44 in the driver. Since it will not move the system's cursor,
45 IT SHOULD NOT have any of those core options, such as
46 "SendCoreEvents" or "AlwaysCore".
47 Option "Device" "path"
49 sets the path to the special file which represents serial
50 line where the tablet is plugged. You have to specify it
51 for each subsection with the same value if you want to have
52 multiple devices with the same tablet. This option is
53 mandatory.
54 Option "USB" "on"
56 tells the driver to dialog with the tablet the USB way.
57 This option is mandatory for USB tablets.
58 Option "ForceDevice" "ISDV4"
60 tells the driver to dialog with the tablet the Tablet PC
61 way. Tablet PC is a serial tablet using a special Wacom IV
62 protocol, called ISDV4 protocol. This option is mandatory
63 for Tablet PC.
64 Option "Suppress" "Inumber"
66 sets the position increment under which not to transmit
67 coordinates. This entry must be specified only in the
68 first Wacom subsection if you have multiple devices for one
69 tablet. If you don't specify this entry, the default value,
70 which is 2, will be used. To disable suppression, the entry
71 should be specified as 0. When suppress is defined, an
72 event will be sent only when at least one of the following
73 conditions is met:
74 the change between the current X coordinate and the
76 previous one is greater than suppress;
77 the change between the current Y coordinate and the
79 previous one is greater than suppress;
80 the change between the current pressure and the
82 previous one is greater than suppress;
83 the change between the current degree of rotation
85 and the previous one of the transducer is greater than sup‐
86 press;
87 the change between the current wheel value and the
89 previous one is equal to or greater than suppress;
90 button value has changed;
92 proximity has changed.
94 Option "Mode" "Relative"|"Absolute"
96 sets the mode of the device.
97 Option "TopX" "number"
99 X coordinate of the top corner of the active zone.
100 Option "TopY" "number"
102 Y coordinate of the top corner of the active zone.
103 Option "BottomX" "Inumber"
105 X coordinate of the bottom corner of the active zone.
106 Option "BottomY" "number"
108 Y coordinate of the bottom corner of the active zone.
109 Option "ButtonsOnly" "on"
111 disables the device's motion events.
112 Option "ButtonM" "AC"
114 reports an action AC when button M is pressed, where M is
115 one of the device supported button numbers, it can be 1
116 to 32. The default action reported to Xinput is mouse but‐
117 ton M click. To assign it to a left-double-click, use
118 "dblclick 1". To ignore the button click, i.e., to not
119 report any button click event to Xinput, use "0" or "but‐
120 ton 0". Use "modetoggle" to assign it to switching between
121 relative and absolute mode, which is useful to switch win‐
122 dows in a multi-monitor environment.
123 Option "TPCButton" "on"
125 enables the stylus buttons as Tablet PC buttons, i.e.,
126 reports stylus button event only when its tip is pressed.
127 Default to "on" for Tablet PC; "off" for all the other mod‐
128 els.
129 Option "Speed" "Rspeed"
131 sets the cursor's relative movement speed to Rspeed. The
132 default value is 1.0. A Rspeed greater than 1.0 will speed
133 up the cursor's relative movement. A Rspeed less than 1.0
134 but greater than 0 will slow down the cursor's relative
135 movement. A Rspeed too close to 0 is not recommanded.
136 Option "Twinview" "horizontal"|"vertical"|"none"
138 sets the orientation of TwinView to map the tablet to one
139 screen and to be able to move the screen cursor from one
140 screen to the other when tool reaches the edge of the
141 tablet. The cursor can be constrained in a specific screen
142 if "ScreenNo" option is added. If you want to map the
143 tablet to the whole desktop, you should NOT add this
144 option. The default is "none".
145 Option "TVResolution" "res1,res2"
147 specifies different resolutions for the two screens in
148 TwinView setup. For example, if the resolution of screen 1
149 (res1) is 1024x768 and screen 2 (res2) is 1280x1024, the
150 option will be set to:
151 Option "TVResolution" "1024x768,1280x1024" This
152 option is used only when TwinView option is not none. It
153 is unnecessary to add this option if your screens are dis‐
154 playing in the same resolutions.
155 Option "ScreenNo" "n"
157 In a multi-monitor environment, specifies the screen number
158 in which the cursor can move.
159 Option "Rotate" "CW"|"CCW"|"HALF"|"NONE"
161 rotates the tablet orientation clockwise (CCW) or anti-
162 clockwise (CW) or 180 degrees (HALF). The default is
163 "NONE".
164 Option "PressCurve" "x1,y1,x2,y2"
166 sets pressure curve by control points x1, y1, x2, and y2.
167 Their values are in range from 0..100. The input for
168 linear curve (default) is "0,0,100,100"; slightly
169 depressed curve (firmer) might be "5,0,100,95";
170 slightly raised curve (softer) might be "0,5,95,100".
171 Option "KeepShape" "on"
173 When this option is enabled, the active zone begins
174 according to TopX and TopY. The bottom corner is adjusted
175 to keep the ratio width/height of the active zone the same
176 as the screen while maximizing the area described by TopX,
177 TopY, BottomX, BottomY.
178 Option "DebugLevel" number
180 sets the level of debugging info reported. There are 12
181 levels, specified by the integers between 1 and 12. Once
182 it is defined, all the debug messages with a level less
183 than or equal to the number will be logged into
184 /etc/X11/XFree86.0.log.
185 Option "CursorProx" "number"
187 sets the max distance from tablet to stop reporting move‐
188 ment for cursor in relative mode. Default for Intuos series
189 is 10, for Graphire series (including Volitos) is 42.
190 Option "Serial" "number"
192 sets the serial number associated with the physical device.
193 This allows to have multiple devices of the same type (i.e.
194 multiple pens). This option is only available on wacom V
195 devices (Intuos series and Cintiq 21U). To see which
196 serial number belongs to a device, you have to set the
197 DebugLevel to 6 and watch the output of the X log.
198 Option "Threshold" "number"
200 sets the pressure threshold used to generate a button 1
201 events of stylus. The default is MaxPressure*3/50.
202
204 Xorg(1x), xorg.conf(5x), xorgconfig(1x), Xserver(1x), X(7).
205
207 Frederic Lepied <lepied@xfree86.org> Ping Cheng <pingc@wacom.com> John
208 E. Joganic <jej@j-arkadia.com>
209X Version 11 linuxwacom 0.7.6 WACOM(4)