The KCM Tablet Handbook
This is the documentation for the module that configures graphic tablets.

Wacom Tablet Settings
The tablet module handles all setting for your graphic tablet. All tablets supported by the Wacom driver project are handled by this settings interface. Make sure your tablet is detected either via xorg.conf or udev and works in general. Refer to the tablet detection section for more information.
The xf86-input-wacom driver must be installed on your computer and xsetwacom must be available in order to make this module work correctly.
The module is split into various tab pages that handle all aspects of your tablet and the pen: Profiles, General Information, Stylus Settings, Express Buttons, Pad Mapping and Touch Mapping.

Profile Management
This is the small drop down box with the two buttons next to it. You can create new profiles and delete already existing ones. Each profile is saved and specified for the currently connected tablet. If you create a new profile, it automatically creates one with the default settings as returned by the driver.
Here you can specify different profiles for your settings. For example if you like to have a different behavior of the pen when you use it as a mouse replacement for your day to day work or using it as pen to draw something.
Each profile can be changed on the fly and directly changes the behavior of your tablet input.
The kded tablet daemon must be running in the background to be able to change the profiles and apply them to the tablet. All the work is done by the daemon. The module just change the profile settings for it.

General Tablet Settings and Information
Shows some general Information about the detected tablet. Beside the name and company of your tablet an image is shown and all detected input devices are listed.
The tablet must be connected and the kded must be running to allow the module to work correctly.
See the Detection problems section for further help on the tablet detection.
In addition to the tablet information the general tab allows to set various global shortcuts. Each shortcut allows to dynamically change the options for the current connected tablet.

Stylus Settings
The pen that is used together with the tablet has two different sides, the main side is called stylus the other end is the eraser. In this tab you can change any aspect of the pen from the button assignment to the pressure curve and threshold.

Eraser Feel
The slider allows to alter the threshold of the eraser. For a more fine grained setting of the pressure it is possible to alter the complete pressure curve in the Edit Pressure Curve dialog. See Press Curve Dialog for more information.

Button Settings
The Button Settings box allows to alter the executed action assigned to each button of the pen. A simple click into the edit box opens a new dialog where different key combinations, modifier keys and mouse buttons can be selected.
If Tap to execute action is enabled the stylus must be in contact with the tablet in order to allow the button action to be executed. If this option is disabled each button action works also when the stylus is hovering above the tablet.

Tip Feel
The slider allows to alter the threshold of the stylus tip. For a more fine grained setting of the pressure it is possible to alter the complete pressure curve in the Edit Pressure Curve dialog. See Presscurve Dialog for more information.

Express Buttons
The Express Buttons tab allows to set specific button actions for all hardware buttons for the tablet. To change the used action, you need to click into the edit box and choose the action in the new dialog.

Tablet
The Tablet tab allows to set further properties of the tablet area when used together with a pen. In here the orientation of the tablet area, valid space of the used tablet and the cursor tracking mode can be specified.

Stylus Tracking Mode
Map to Screen : This mode maps the pen cursor with absolute movement to the tablet. The edges of the tablet represent directly the space of the screen.
Map to Cursor : This mode maps the pen cursor with relative movement to the tablet.

Orientation
The orientation box specifies how the tablet area is rotated. You can set a specific rotation on your own in the combobox or if you enable the Auto-Rotate with Screen option, the tablet will automatically rotated together with the screen. This is done by listening to the xrandr events when the screen is rotated.
If you have problems with the autorotation option and the tablet is always rotated into the wrong direction, enable the Invert Auto-Rotation option to invert this.

Tablet Mapping
This mapping allows to specify the proportions of the tablet that will be used for each screen. This is necessary to keep the tablet area proportional to the used screen space in absolute stylus tracking mode. For more information check the Area Selection Dialog section.
This option does not work for relative cursor mode.

Touch
The Touch tab allows to set further properties for the touch part of the tablet (if available). It is possible to disable the touch feature via the Enable Touch check box. Also a global shortcut exist that allows to enable/disable the touch feature.

Touch Tracking Mode
Map to Screen : This mode maps the touch cursor with absolute movement to the tablet. The edges of the tablet represent directly the space of the screen.
Map to Cursor : This mode maps the touch cursor with relative movement to the tablet.

Gestures
If Enable Gestures is enabled, the tablet can generate gesture events for the touch device.
Scroll Distance : Allows to scroll through windows when two fingers are placed on the tablet, moving them up/down creates a scroll event. The Distance is given in tablet units.
Zoom Distance : Allows to zoom in/out by moving two fingers together or apart from each other. The Distance is given in tablet units.
Tap Time : This time in milliseconds specifies when a double tap on the device is recognized as right-click

Touch Mapping
This mapping allows to specify the proportions of the touch device that will be used for each screen. This is necessary to keep the tablet area proportional to the used screen space in absolute stylus tracking mode. For more information check the Area Selection Dialog section.
This option does not work for relative cursor mode.

Press Curve Dialog
Here's a screenshot of the Press Curve dialog
Changing the press curve
The press curve defines how the pressure of the stylus is translated. The press curve is defined via four points of a Bézier curve. To change this curve you can alter the red dots and move the curve around.
Use your pen inside the press curve dialog to see the changes in the press curve directly. A blue area below the curve shows the applied pressure of the pen.

Area Selection Dialog
Here's a screenshot of the Tablet Area Dialog
Defining the Tablet Area
This dialog allows to specify the available tablet area for each selected screen space. In order to keep the aspect ratio of the tablet it is necessary to reduce the tablet area depending on the screen resolution. This Dialog allows to specify them for each screen individually.
Use the Toggle Screen button to switch between fullscreen (all connected monitors) and each individual monitor. The settings will be saved for each screen configuration and applied to the tablet whenever the screen selection is switched by the global shortcut action.
It is possible to map the screen with the Full Tablet area or just defined Tablet Area on the Tablet pane rightwards. The proportions of the area can be locked or unlocked using the Lock proportions switch button.
If you want to keep the aspect ratio of the tablet with the current screen selection you can press the Set Screen Proportions button. The tablet area will be calculated and changed automatically.
In addition you can open the Calibrate dialog to calibrate your tablet with the help of four points on the screen.
When the dialog is closed, the last selected screen will be used. If you want to switch the screen later on, you can use the Global Shortcut.
The tablet area only works for absolute tracking mode of the touch and pen cursor device. In relative mode the full tablet is used.