From cc72db48fb14b225de4a3f83046c0b4e3c1802a3 Mon Sep 17 00:00:00 2001 From: Peter Hutterer Date: Mon, 13 Apr 2026 10:09:39 +1000 Subject: [PATCH] doc/user: add an illustration of the touch arbitration rectangle Part-of: --- doc/user/meson.build | 1 + doc/user/svg/tablet-touch-arbitration.svg | 245 ++++++++++++++++++++++ doc/user/tablet-support.rst | 16 +- 3 files changed, 261 insertions(+), 1 deletion(-) create mode 100644 doc/user/svg/tablet-touch-arbitration.svg diff --git a/doc/user/meson.build b/doc/user/meson.build index 94384492..0e56d415 100644 --- a/doc/user/meson.build +++ b/doc/user/meson.build @@ -131,6 +131,7 @@ src_rst = files( 'svg/tablet-intuos-modes.svg', 'svg/tablet-left-handed.svg', 'svg/tablet-out-of-bounds.svg', + 'svg/tablet-touch-arbitration.svg', 'svg/tablet.svg', 'svg/tap-n-drag.svg', 'svg/thumb-detection.svg', diff --git a/doc/user/svg/tablet-touch-arbitration.svg b/doc/user/svg/tablet-touch-arbitration.svg new file mode 100644 index 00000000..47862b01 --- /dev/null +++ b/doc/user/svg/tablet-touch-arbitration.svg @@ -0,0 +1,245 @@ + + + + + + + + + + + + + + + + + image/svg+xml + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/doc/user/tablet-support.rst b/doc/user/tablet-support.rst index 1b43cb98..c877765c 100644 --- a/doc/user/tablet-support.rst +++ b/doc/user/tablet-support.rst @@ -466,7 +466,21 @@ devices arbitration has to be done in userspace. libinput uses the **libinput_device_group** to decide on touch arbitration and automatically discards touch events whenever a tool is in proximity. -The exact behavior is device-dependent. +The exact behavior is device-dependent but typically comes in two forms: full +tablet touch arbitration and partial arbitration. + +.. figure:: tablet-touch-arbitration.svg + :align: center + + Partial touch arbitration during a pen interaction for left-handed + and right-handed pen tilt. + +Full arbitration simply disables touch on the device while the pen is in +proximity. Partial touch arbitration disables the side of the tablet around the +user's hand, starting slightly to the side of the pen tip. If the pen tilts +to the left (pen held in the left hand), the rectangle is to the left of the +pen tip, if the pen tilts to the right (pen held in the right hand) it is to +the right of the pen tip. .. _tablet-area: