• Home
  • History
  • Annotate
Name Date Size #Lines LOC

..07-Dec-2021-

READMEH A D07-Dec-20211.7 KiB4532

evdevtablet.jsonH A D07-Dec-202134 43

evdevtablet.proH A D07-Dec-2021238 149

main.cppH A D07-Dec-20212.6 KiB7223

README

1Generic plug-in for accessing pen-based tablets via evdev
2
3To test, run the demo app from examples/widgets/tablet with the
4command-line argument -plugin EvdevTablet
5
6Known to work with 3rd generation Wacom Bamboo Pen & Touch. Recent
7tablets like this one may need an updated wacom kernel driver for
8kernels 3.2 and older.
9
10Supports x, y, pressure, pen & eraser pointer types, proximity enter,
11proximity leave. The additional advanced fields of QTabletEvent will
12not be utilized.
13
14Connecting the tablet will result in two input devices: one for finger
15touch and the tablet buttons, and another for pen input including the
16stylus buttons. This plugin cares about the latter only. For touch,
17try the evdevtouch plugin.
18
19The plugin generates QTabletEvents only. For compatibility with Qt 4,
20TabletPress, Move and Release are only sent when the stylus is
21touching the screen.
22
23TabletEnterProximity and TabletLeaveProximity are always sent to the
24QGuiApplication instance. Use an event filter (or subclass) to handle
25these. In proximity events most of the data (incl. position) will be
26left unspecified as these are mere indication of the fact that the
27stylus entered the range of the tablet.
28
29When running under X, it is likely that no events are received due to
30the input device being grabbed. A temporary workaround is to disable
31the device from X via
32xinput set-prop <device> <device enabled property> 0.
33
34
35TODO #1: Indicate motion when lifted but still in proximity. Needs new
36event types.
37
38TODO #1.1: Where to report ABS_DISTANCE? Needs a new QTabletEvent member
39(unless we hijack z).
40
41TODO #2: QKeyEvent from the stylus buttons (BTN_STYLUS, BTN_STYLUS2,
42but there are no suitable Qt::Key_* constants?)
43
44TODO #3: QKeyEvent in evdevtouch (or this plugin?) from tablet buttons
45