mirror of
https://github.com/DeeJanuz/frametop.git
synced 2026-10-06 08:00:09 +02:00
33 lines
1.6 KiB
Markdown
33 lines
1.6 KiB
Markdown
# Controller desktop click stability
|
||
|
||
Trigger presses reach KDE immediately, but controller motion within 8 logical
|
||
pixels of the press stays at that position until release. Releasing without a motion outside this
|
||
zone delivers the click at the original position, even if the hand moved during
|
||
release. Moving outside the zone begins a normal drag immediately; returning to
|
||
the zone does not turn it back into a click. There is no hold-duration timer.
|
||
|
||
This filters overlay pointer content events on desktop monitors only. Native mouse
|
||
input, SteamVR UI, separate screen grab bars and floating-app title-bar carrying
|
||
are unaffected. Multi-button gestures keep their existing behavior. A motion
|
||
onto another desktop monitor starts a drag; cross-monitor motion is not stabilized.
|
||
|
||
CLI (runtime preferences, reset to 8 on desktop restart):
|
||
|
||
```sh
|
||
input/ft-clickctl status
|
||
input/ft-clickctl threshold 8
|
||
input/ft-clickctl threshold 0 # disable without a restart
|
||
```
|
||
|
||
Thresholds are 0–64 logical pixels, normalized to each panel's KDE scale.
|
||
Status reports held state, suppressed motions, stabilized clicks and drags.
|
||
Changing the threshold while a controller button is held is refused.
|
||
|
||
This is a separate contribution from desktop mouse/controller ownership. Its
|
||
hardware validation must check small controls, intentional text selection,
|
||
long presses, cross-monitor dragging and simultaneous mouse use. The existing
|
||
renderer laser remains tracked; this change stabilizes desktop input rather
|
||
than smoothing the visual laser. Default threshold is a starting point to test.
|
||
|
||
Run `scripts/test-controller-click.sh` for the isolated gesture-state tests.
|