KDE 4 KCModule

This module implements a GUI for the Wacom Linux Drivers and extends it
with profile support to handle different button / pen layouts per profile.

For hardware support have a look at http://www.linuxwacom.sourceforge.net

Easy profile switching is added via a small plasma applet.
In addition a daemon running in the background helps with hotplug support.

All tablets can be set up as long as they are found with the wacom kernel module.

Check with
$ xsetwacom list devices
if your device is correctly recognized first. If it dosn't show up here I can't configure it.

Components:
* kded:
	runs in the background, detects a connected tablet and applies the pad button / stylus profile
	detects xrandr rotation and rotates the tablet with it
	apply global shortcuts for the touch on/off stylus feature

* kcontrol module:
	unified gui to set-up the buttons and other aspects of the tablet

* plasma-applet:
	optional applet for easy switching between different profiles

Dependencies:
* wacom tablet driver especially the xsetwacom tool
* xserver-xorg-input-wacom >= 0.20

* kdelibs5-dev
* kdebase-workspace-dev
* xorg-dev
* xserver-xorg-dev
* libxi-dev
* libxinerama-dev
* x11proto-xinerama-dev
* libxrandr-dev

#################################################################
# build debian package

$ debuild -us -uc -b

#################################################################
# or install with

$ mkdir build
$ cd build
$ cmake ../ -DCMAKE_INSTALL_PREFIX=`kde4-config --prefix` -DCMAKE_BUILD_TYPE=release
$ make
$ make install

#################################################################
# start with

First the background daemon must be running. You can logout/login or restart the kded with
$ kquitapp kded
$ kded4

Afterwards you get a notice when you plugin your device and can configure it via

$ kcmshell4 kcm_wacomtablet
or have a look in the system settings where the keyboard and mouse settings are


#################################################################
# execute unit tests
To run the unit-test add the KDE4_BUILD_TESTS=ON variable to the cmake call

$ mkdir build
$ cd build
$ cmake ../ -DCMAKE_INSTALL_PREFIX=`kde4-config --prefix` -DKDE4_BUILD_TESTS=ON
$ make

execute all tests via:

$ ctest

or a single one via
$ cd /build/autotests/common/property
$ ./Property.shell

you can find the testresults in

build/Testing/Temporary/LastTest.log

##################################################################
# Add missing tablet devices

If your device is not recognized by this program but you can set it up via the xsetwacom driver.
You can add the missing lines yourself.

All you need is the tabletID.

------------------------------------------------
Step 1) Get real internal Tablet name

xsetwacom list dev

for my Wacom Bamboo:
Wacom Bamboo eraser ERASER
Wacom Bamboo cursor CURSOR
Wacom Bamboo pad PAD
Wacom Bamboo     STYLUS

------------------------------------------------
Step 2) Then you need the Tablet ID

xsetwacom get "Wacom Bamboo" tabletid

for my Wacom Bamboo:
101

------------------------------------------------
Step 3) Transform it into Hexadecimal

For my Wacom Bamboo: 0065

------------------------------------------------
Step 4) Add a new section into the right datafile
look at /usr/share/kde4/apps/wacomtablet/data/

for the Wacom Bamboo the right file is: wacom_devicelist

Add a new entry

for my Wacom Bamboo:

[0065]
model=MTE_450        # try to google for it but not used right now
layout=bl_6          # can be empty if no button layout is available that exists (see images dir)
name=Wacom Bamboo    # name as found above
padbuttons=4         # available buttons on the pad
wheel=no
touchring=yes
touchstripl=no
touchstripr=no
hwbutton1=1          # these mag the physical button numbers to what the XServer likes to name them
hwbutton2=2          # see below for more information
hwbutton3=3
hwbutton4=8

--------------------------------------------------------------------
hwbuttonX explanantion:

Kernels >= 2.6.38 renamed the buttons for some reason.

xsetwacom does not work with the pysical hardware button numbers 1-X
but rather with the real numbers as seen by the XServer

In case you run into trouble with the buttons do the following:
* deinstall the kded/kcm ;)
* disconnect/reconnect the tablet
* run xev in the terminal
* move the mouse over the new window
* press the hardware buttons and write down what button xev sees

and now update the wacom_device list accordingly

for the new Pen & touch tablets before the kernel 2.6.38 we got
hwbutton1=1
hwbutton2=2
hwbutton3=3
hwbutton4=8

for kernels >= 2.6.38 we get
hwbutton1=3
hwbutton2=8
hwbutton3=9
hwbutton4=1






