S3DV viewer
3D stream playback / verification viewer
S3DV viewer is a native macOS viewer for playing back and verifying recorded .s3dv time-series 3D streams. WKWebView + three.js (r180) batched rendering delivers one draw call per arena.
Frame-complete presentation
Designed so that each frame is rendered completely before moving to the next, even under heavy load. Received packets are buffered in an inbox and applied in order within the render tick before a single frame is presented. If the budget is exhausted, intermediate frames are dropped and only the later complete state is presented — so a torn frame (e.g. half-applied snapshot) is never shown.
- Presented frames are always complete scene states at packet boundaries — partially applied states are never shown
- Under load, load time is taken and frames are dropped — per-tick apply budget (default 6 ms); overflow is folded into the next complete state
- Textures are incorporated after decode completes — no white unrendered frames
- Hidden windows apply on arrival — pacing is disabled when rAF is throttled to ~1 Hz, preventing packet backlog
Key features
- Packet integrity: engine sent count == page applied count (page packets == framesSent)
- Batched rendering: one arena = one draw call; 8,236 chunks reduced to ~10 draw calls
- Memory budget governor: oldest/outer chunks evicted when resident geometry budget is exceeded
- Crash safety: WebContent process termination detected and auto-recovered (max 2 times)
- CLI control: full operation via
s3dvctlover UNIX socket (open/pause/step/seek/speed/presentation/applybudgetms/bench/screenshot/wait/quit) - Settings: presentation mode (frameComplete/immediate) and apply budget (1–50 ms) switchable live
Download
Download the app bundle from GitHub Releases. Ad-hoc signed (not Apple-notarized), so on first launch allow it in System Settings > Privacy & Security.
Documentation
- README (usage, settings, CLI)
- Design and verification (research repo)
- CLI reference (research repo)
Verification results (v1.2.0)
| Item | Result |
|---|---|
| swift test (regression tests) | 45 / 45 pass |
| verify_app.sh (full matrix) | 7 / 7 PASS |
| verify_cli.sh (all CLI commands) | 21 / 21 PASS |
| Packet match (1.27 GB GT stream) | 24,494 / 24,494 (100%) |
| Console ERROR | 0 |
| Leak (10 cycles) | -0.46 MB/cycle (< 5 MB/cycle) |
Developer
Yuki_Orita (折田悠希 / おりたゆうき) · GitHub · X (formerly Twitter) · Studio Rizi
Open source (MIT License). Bug reports / announcements: Discord