mirror of
https://github.com/DeeJanuz/frametop.git
synced 2026-10-06 14:00:10 +02:00
DeeJanuzandClaude Opus 5.5
540d8c425c
The 3D mouse drives SteamVR's laser through the ft_pointer virtual controller, so its events reach the screens the same way a controller's do. The filter held every press, which turned the mouse's short drags (selecting a character or two, nudging a slider) into clicks. Mark button events from hand controllers and start the filter only on those. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
35 lines
1.7 KiB
Markdown
35 lines
1.7 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, and only
|
||
presses from hand controllers start it. The 3D mouse (whose laser comes from the
|
||
`ft_pointer` virtual controller), 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.
|