Chapter 17. Graphics tablets
Chapter 17. Graphics tablets To manage Wacom tablets connected to your system, use the following tools: The gnome-settings-daemon service The Wacom Tablet settings panel in the GNOME environment The Wacom Tablet settings panel for a tablet The Wacom Tablet settings panel for a grip pen Both these tools, as well as the libinput stack, use the libwacom tablet client library, which stores the data about Wacom tablets. If you want to add support for a new tablet into the libwacom library, you must ensure that a definition file for this new tablet exists. 17.1. Preparing a tablet definition file You must prepare a definition file for the tablet you want to add. Prerequisites List all local devices recognized by libwacom : Make sure that your device is recognized in the output. If your device is not listed, the device is missing from the libwacom database. However, the device might still be visible as an event device in the kernel under /proc/bus/input/devices , and if you use the X.Org display server, in the X11 session on the xinput list. Procedure Install the package that provides tablet definition files: The package installs tablet definitions in the /usr/share/libwacom/ directory. Check whether the definition file is available in the /usr/share/libwacom/ directory. To use the screen mapping correctly, support for your tablet must be included in the libwacom database and in the udev rules file. Important A common indicator that a device is not supported by libwacom is that it works normally in a GNOME session, but the device is not correctly mapped to the screen. If the definition file for your device is not available in /usr/share/libwacom/ , you have these options: The required definition file may already be available in the linuxwacom/libwacom upstream repository. You can try to find the definition file there. If you find your tablet model in the list, copy the file to the local machine. You can create a new tablet definition file. Use the data/wacom.example file below, and edit particular lines based on the characteristics of your device. Example 17.1. Example model file description for a tablet 17.2. Adding support for a new tablet You can add support for a new tablet into the libwacom tablet information client library by adding the definition file for the tablet that you want to add. Prerequisites The definition file for the tablet that you want to add exists. For more information about ensuring that the definition file exists, see Section 17.1, "Preparing a tablet definition file" . Procedure Add and install the definition file with the .tablet suffix: After it is installed, the tablet is part of the libwacom database. The tablet is then available through libwacom-list-local-devices . Create a new /etc/udev/rules/99-libwacom-override.rules file with the following content so that your settings are not overwritten: Reboot your system. 17.3. Listing available Wacom tablet configuration paths Wacom tablet and stylus configuration files are saved in the following locations by default: Tablet configuration /org/gnome/settings-daemon/peripherals/wacom/ <D-Bus_machine - id> - <device_id> Wacom tablet configuration schema org.gnome.settings-daemon.peripherals.wacom Stylus configuration /org/gnome/settings-daemon/peripherals/wacom/ <device_id> / <tool_id> . If your product range does not support <tool_id> , a generic identifier is used instead. Stylus configuration schema for org.gnome.settings-daemon.peripherals.wacom.stylus Eraser configuration schema org.gnome.settings-daemon.peripherals.wacom.eraser Prerequisites The gnome-settings-daemon package is installed on your system. Procedure List all tablet configuration paths used on your system: Important Using machine-id , device-id , and tool-id in configuration paths allows for shared home directories with independent tablet configuration per system. However, when sharing home directories between systems, the Wacom settings apply only to one system. This is because the machine-id for your Wacom tablet is included in the configuration path of the /org/gnome/settings-daemon/peripherals/wacom/machine-id-device-id GSettings key, which stores your tablet settings.
libwacom-list-local-devices dnf install libwacom-data The product is the product name announced by the kernel Product=Intuos 4 WL 6x9 Vendor name of this tablet Vendor=Wacom DeviceMatch includes the bus (usb, serial), the vendor ID and the actual product ID DeviceMatch=usb:056a:00bc Class of the tablet. Valid classes include Intuos3, Intuos4, Graphire, Bamboo, Cintiq Class=Intuos4 Exact model of the tablet, not including the size. Model=Intuos 4 Wireless Width in inches, as advertised by the manufacturer Width=9 Height in inches, as advertised by the manufacturer Height=6 Optional features that this tablet supports Some features are dependent on the actual tool used, e.g. not all styli have an eraser and some styli have additional custom axes (e.g. the airbrush pen). These features describe those available on the tablet. # Features not set in a file default to false/0 This tablet supports styli (and erasers, if present on the actual stylus) Stylus=true This tablet supports touch. Touch=false This tablet has a touch ring (Intuos4 and Cintiq 24HD) Ring=true This tablet has a second touch ring (Cintiq 24HD) Ring2=false This tablet has a vertical/horizontal scroll strip VStrip=false HStrip=false Number of buttons on the tablet Buttons=9 This tablet is built-in (most serial tablets, Cintiqs) BuiltIn=false cp <tablet_definition_file>.tablet /usr/share/libwacom/ ACTION!="add|change", GOTO="libwacom_end" KERNEL!="event[0-9]*", GOTO="libwacom_end" [new tablet match entries go here] LABEL="libwacom_end" /usr/libexec/gsd-list-wacom