nikrozman/air-mouse
1
0
Fork 0
Code Issues 2 Pull Requests Actions Packages Projects 2 Releases Activity

Improve gravity-based roll correction #1

New Issue
Closed
opened 2026-03-01 22:43:37 +01:00 by nikrozman · 0 comments
nikrozman commented 2026-03-01 22:43:37 +01:00
Owner
Copy Link
Copy Source

Replaced the old roll angle tracking (complementary filter / decay integrator) with gravity-vector axis decomposition. Angular velocity is now projected onto world-aligned axes using a low-pass filtered accelerometer gravity estimate, so cursor movement stays screen-aligned regardless of device roll.

Horizontal tracking works well. Vertical (pitch/nod) feels slightly less responsive... currently using a hardcoded 1.3x pitch scale factor as a workaround. I think the root cause is that the yaw projection picks up incidental GY (wrist roll) via the gy*gny dot product term when the device is tilted, making horizontal feel relatively more sensitive. Pitch has no equivalent boost since the screen-right vector always has ry=0.

TODO:

  • Consider making pitch scale a configurable slider in the web UI
  • Test at various holding angles (flat, 30°, 60° tilt)
Replaced the old roll angle tracking (complementary filter / decay integrator) with gravity-vector axis decomposition. Angular velocity is now projected onto world-aligned axes using a low-pass filtered accelerometer gravity estimate, so cursor movement stays screen-aligned regardless of device roll. Horizontal tracking works well. Vertical (pitch/nod) feels slightly less responsive... currently using a hardcoded 1.3x pitch scale factor as a workaround. I think the root cause is that the yaw projection picks up incidental GY (wrist roll) via the gy*gny dot product term when the device is tilted, making horizontal feel relatively more sensitive. Pitch has no equivalent boost since the screen-right vector always has ry=0. TODO: - [ ] Consider making pitch scale a configurable slider in the web UI - [ ] Test at various holding angles (flat, 30°, 60° tilt)
nikrozman added this to the Software project 2026-03-03 00:06:59 +01:00
nikrozman added this to the v1 release milestone 2026-03-03 00:07:00 +01:00
nikrozman moved this to Done in Software on 2026-03-03 00:07:21 +01:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
bug
Something is not working
 duplicate
This issue or pull request already exists
 enhancement
New feature
 help wanted
Need some help
 invalid
Something is wrong
 question
More information is needed
 wontfix
This won't be fixed
No labels
Milestone
No items
No Milestone v1 release
Projects
Clear projects
No projects
Software
Done
Assignees
Clear assignees
nikrozman (Nik Rozman)
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: nikrozman/air-mouse#1