Touchscreen¶

Inherits

Device

Note

Touchscreen support is experimental.

Properties¶

Property	Type	Description	Default
motion_threshold	number	For accurately determining the direction of swipe triggers. In millimeters.	`4`
swipe.angle_tolerance	number	Angle tolerance for the `left`, `right`, `up`, `down`, `left_right` and `up_down` directions of TouchscreenSwipeTrigger. The remaining space is used for diagonal directions. Min: `0` Max: `45`	`20`

Property

Type

Description

Default

motion_threshold

number

For accurately determining the direction of swipe triggers. In millimeters.

4

swipe.angle_tolerance

number

Angle tolerance for the left, right, up, down, left_right and up_down directions of TouchscreenSwipeTrigger. The remaining space is used for diagonal directions.

Min: 0
Max: 45

20

Event filtering¶

Touchscreen event filtering requires blocking all events by default until a gesture is recognized. Setting the gestures property on TouchscreenEventHandler changes the behavior of the following actions:

hold - latency increased by 50 ms
motion - threshold for each finger increased by 4 mm
tap - latency increased by 50 ms

Window under fingers¶

Information about the window located under the center of all touch points is available in window_under_fingers_* variables.

KWin and multiple touchscreens¶

The KWin plugin may currently not process touchscreen input correctly if multiple devices are present. In such situations, a device rule must be created to ignore all but one touchscreen.

device_rules:
  - conditions:
      - $touchscreen
      - $name != device_name # replace 'device_name' with the device's name
    ignore: true