This is a driver for Wacom Graphics Tablets. These tablets typically work with
the driver from 'The Linux Wacom Project' under linux.
Alexandre Balaban
alexandre(-()-)balaban(-.-)fr
http://www.balaban.fr
License
-------
This driver uses parts of code from "The Linux Wacom Project", as such it's
bound to the GPL v2. See attached file "GPL" for the complete text of this
license.
Installation
------------
copy WacomTablet.usbfd to devs:usb/fd/
copy WacomTablet.fdclass to devs:usb/fdclasses/
Reboot or try C:USBCtrl RESTART to load the driver, then insert your tablet in
a usb slot.
Usage
-----
The driver has a configuration GUI which is hidden by default by works as a
commodity so can be brought up by pressing 'ctrl alt w' or via Exchange.
The GUI has two sides, the left shows the current position and pressure (in
tablet coords) and below that the maximum values that have occured during this
session. The right hand side shows the current settings, the range of tablet
coords that are mapped onto the screen and the value of the pressure for
maximum.
In the centre there is an area for pressure testing. The current X and Y coords
will be shown anywhere on the screen, but the current pressure will only be
shown
when pressing on the test area.
You can move the pen arround and press on the nib to find the maximum values,
then copy them to the settings, or choose a smaller area if you prefer. You
might want to do that if your screen has a different aspect to your tablet,
otherwise generally you will want the maximums.
Beneath the pressure test area is a group of 7 sliders, these enable you to
create a pressure sensitivity profile. The default is a linear just diagonal
straight line. If you make the line curve above the diagonal you increase the
sensitivity at lower presssures and if it curves below sensitivity decreases at
lower pressure. If you slant the diagonal the other way then you invert the
pressure so that a light touch acts as if hard. Beware this is very useful in
some situation but some apps may not like it at all!
You can also choose whether to send NEWTABLET (recommended) or the old TABLET
(for compatibility with old apps). (having allowed this option so far most apps
I've tried work with NEWTABLET.) Also you have the option to send additional
RAWMOUSE events, which enable some software such as popupmenu.class (< 53.8) to
see the pointer movements.
SAVE saves the settings and closes the window
USE uses them for the curent session only,
COPY MAXIMUMS copies the max values recorded in that session for you.
The config is saved in the following preferences file: ENVARC:WacomPrefs.xml
Supported tablet informations
-----------------------------
This driver supports both NewTablet event and old ones. Depending on the actual
capabilities of the tablet hooked up, the following information are supported.
All information from the old PointerTablet structure are suported:
* X and Y Ranges
* X and Y positions
* Pressure (-128 to +127)
From the NewTablet the following information are supported:
* X, Y and Z positions
* X, Y and Z ranges
* Pressure
* X, Y and Z angle
* Buttons bits
* Proximity notification
Additionnaly this driver also supports sending a custom tag in order to indicate
which tool is actually being reported by the event. This is done by the tag
TABLETA_Tool whose value is currently (TABLETA_Dummy + 0x10B)
Possible values for this tag are :
0 BTN_TOOL_PEN: the stylus using its usual nib,
1 BTN_TOOL_RUBBER: the stylus using its opposite end,
2 BTN_TOOL_BRUSH: a special stylus (or nib) representing a brush
3 BTN_TOOL_PENCIL: a special stylus (or nib) representing pencil
4 BTN_TOOL_AIRBRUSH: a special stylus (or nib) reprensting airbrush
5 BTN_TOOL_FINGER: a single finger touch on a touchable part of the tablet
6 BTN_TOOL_MOUSE: a compatible mouse
7 BTN_TOOL_LENS: use the lens
8 BTN_TOOL_DOUBLETAP: a double finger touch on touchable parts of the tablet
9 BTN_TOOL_TRIPLETAP: a triple finger touch on touchable parts of the tablet
Tested machines and OSes
------------------------
Any AmigaOS4 supported machines should be ok, anyway it's been formally reported
to work on:
- AmigaOne XE/G4, AmigaOS 4.1 update 4
- AmigaOne X1000, AmigaOS 4 beta
- Sam 440, AmigaOS 4.1 update 4
- Sam Flex 440, AmigaOS 4.1 update 4
- Sam 460, AmigaOS 4 beta
Compatible Tablets (possibly)
-----------------------------
The following Tablets are reported to work with the same driver as my tablet on
linux, that means that there is a reasonable chance they'll work with this
driver
or they may not. No guarentees....
The following have been reported to work on Amiga Forums:
Bamboo MTE-450A (my tablet)
Graphire ET-405-U (Davebraco)
Volito FT-405-U (Davebraco)
Bamboo Fun4x6 CTE-450 (mr2)
Bamboo One CTF-430 (Nick Clover)
Intuos3 9x12 (mbrantley)
Intuos2 12x12 XD-1212-U (Martin J.)
These are reported to work on linux with the same driver as my tablets uses:
Wacom Penpartner Wacom Graphire Wacom Graphire2 4x5, 5x7 Wacom Graphire3 Wacom
Graphire3 6x8 Wacom Graphire4 4x5, 6x8 Wacom BambooFun 4x5, 6x8 Wacom Bamboo1
Medium Wacom Volito Wacom PenStation2 Wacom Volito2 4x5, 2x3 Wacom PenPartner2
Wacom Bamboo Wacom Bamboo 2FG, 4x5, Craft Wacom Bamboo1 Wacom BambooFun 2FG 6x8,
2FG 4x5 Wacom Intuos 4x5, 6x8, 9x12, 12x12, 12x18 Wacom PL400, PL500, PL510,
PL550, PL600, PL600SX, PL700, PL800 Wacom DTU710 Wacom DTF521, DTF720, DTF720a
Wacom Cintiq Partner, 21UX, 20WSX, 12WX, 21UX2 Wacom Intuos2 4x5, 6x8, 9x12,
12x12, 12x18 Wacom Intuos3 4x5, 4x6, 6x8, 6x11, 9x12, 12x12, 12x19 Wacom Intuos4
4x6, 6x9, 8x13, 12x19, WL Wacom DTU1931 Wacom ISDv4 90, 93, 9A, 9F, E2, E3
History
-------
v1.0 - 2012-08-01 - Added: tablet buttons configurability
(Public release) - Added: debuglevel env variable load
- Added: tablet capabilities autodetection
- Added: XML preferences file
v0.6 - 08/05/2012 - Fixed: scroll events were only allowing forward scroll
- Fixed: wrong Project for prefs program icon
- Added: mouse and stylus button configurability
v0.5 - 24/04/2012 - Added: extracted tablet handlers to a dedicated file
- Added: extracted supported tablet tables to own file
- Added: a prefs program that shows the GUI (if running)
v0.4 - 19/04/2012 - Added: support for Intuos style tablets
- Fixed: some warnings
- Added: support for horizontal wheel
- Added: support for 4th and 5th button in mouse event
- Added: support for tilt around X, Y and Z in tablet
v0.3 - 16/04/2012 - Fixed: expunge crash
- Fixed: absolute wheel handling
- Added: support for Bamboo Pen & Touch
- Added: support for tool identifying tag
v0.2 - 14/04/2012 - Added: more tablets support
- Added: configurable debug level
- Fixed: Pressure handling now works correctly
- Fixed: Commodities hotkey is "ctrl alt w" now
- Added: Commodities uses tablet name as broker name
v0.1 - 11/04/2012 - First working version.
Donations
---------
If this works for you, I'd like some feedback!
And if you are really pleased consider a donation to Andy as without his tablet
driver as sample I wouldn't have tried to implement this one.
See his donation button on: www.broad.ology.org.uk/amiga/
| |
