Skip to content

Add automatic fine aiming and fix cue rail clearance - #48

Merged
darrinm merged 1 commit into
mainfrom
codex/fine-aim-control
Sep 14, 2026
Merged

darrinm merged 1 commit into
mainfrom
codex/fine-aim-control

Conversation

@darrinm

@darrinm darrinm commented Sep 14, 2026

Copy link
Copy Markdown
Owner

Small pointer movements can swing soft shots too far, and the cue can intersect the table rail while pulled back. This adds automatic fine aiming on mouse and touch and keeps the cue above the cushions and rails.

  • Keep direct dragging for rough aim and power. Holding within 6 pixels for 400 ms enters fine aim with power locked and a visible indicator and cue highlight.
  • Move across the cue to rotate at 0.1° per pixel. Moving 20 pixels along the cue resumes direct aiming without a jump, including side-on and diagonal shots.
  • Retract the cue along its elevated axis and account for cue thickness, spin, and rail bevels when calculating clearance.
  • Keep the immediate first-impact guide horizontal, starting at the cue ball. Update the in-game help and README.

Validation: full unit suite, 26 physics validation checks, and production build. Browser checks cover automatic entry, cue-relative fine adjustment on mobile-size tables, smooth exit, indicator cleanup, cue placement on all four sides, and agreement between displayed aim and the released shot. Geometry tests check cue clearance across directions, pull distances, spin, and corner positions.

@darrinm
darrinm merged commit af24810 into main Sep 14, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant