mirror of
https://github.com/ruvnet/RuView.git
synced 2026-08-21 14:34:56 +00:00
3161af52da
New leaf crate v2/crates/ruview-offaxis implementing ADR-324's projection
core from the published math only (Kooima 2008 generalized perspective
projection; Casiez 2012 one-euro filter) — no code from the unlicensed
prior-art repo. Dependency-free native core; wasm-bindgen surface gated to
wasm32 (cdylib+rlib, ~54 KB wasm after bindgen).
- projection: Screen (3 corners, any orientation) + off_axis() -> typed
errors, never NaN matrices; column-major f64 (three.js Matrix4 layout).
Tests pin the defining invariants: screen corners -> NDC corners for a
grid of eye positions and tilted screens; screen-plane points are
eye-invariant; centered eye reduces to the symmetric frustum; near/far
map to NDC -1/+1.
- filter: one-euro with injected timestamps (no clock in crate);
monotonicity/convergence/NaN-rejection tests.
- rf: field-peak extraction mirroring field_localize.rs constants
(X_SCALE 0.6, Z_SCALE 0.5, PEAK_THRESHOLD 0.35) and the Tier B
coarse-parallax stage (deadband, gain, hard clamp) so over-claiming is
impossible at the API level. No accuracy numbers asserted.
- wasm: OffAxisCamera + RfParallax bindgen classes; per-frame updates hold
last good state instead of throwing.
- benches (criterion): full Tier B frame ~598 ns; argmax scan optimized
-18%/-33% (20x20/100x100). MEASURED table + reproducer in README.
- examples/three.js/demos/07-off-axis-window.html: demo with SYNTHETIC
mouse simulator and labeled RF Tier B mode ('coarse body parallax - not
head tracking'), physical calibration panel, /ws/sensing input, and a
build-instructions overlay when the local pkg/ output is missing
(generated artifacts stay uncommitted; .gitignore entry added).
- Validated 23 unit tests + doctest, clippy clean, wasm32 release build,
Node smoke test of the bindgen output, and a headless-Chromium run of
the demo (engine load, eye response, mode labels, ws failure path).
- ADR-324: header + section 2.5 amendment recording the Rust/WASM core.
Co-Authored-By: claude-flow <ruv@ruv.net>
Claude-Session: https://claude.ai/code/session_01BU3NcEgTpAVvu5QGtw4czT
|
||
|---|---|---|
| .. | ||
| adr | ||
| archtocode-visual-overview | ||
| benchmarks | ||
| ddd | ||
| design | ||
| edge-modules | ||
| huggingface | ||
| integration | ||
| integrations | ||
| prd | ||
| qe-reports | ||
| releases | ||
| research | ||
| schemas | ||
| security | ||
| tutorials | ||
| ADR-110-BRANCH-STATE.md | ||
| ADR-110-REVIEW-GUIDE.md | ||
| build-guide.md | ||
| calibration-guide.md | ||
| observability.md | ||
| proof-of-capabilities.md | ||
| readme-details.md | ||
| RELEASE-streaming-engine-v0.3.0.md | ||
| security-audit-wasm-edge-vendor.md | ||
| TROUBLESHOOTING.md | ||
| trust-and-engine-errors.md | ||
| user-guide-apple-homepod.md | ||
| user-guide.md | ||
| vendor-rf-providers.md | ||
| wifi-mat-user-guide.md | ||
| WITNESS-LOG-028.md | ||
| WITNESS-LOG-110.md | ||