S3DV viewer
時系列3Dストリームの再生・検証用ビューア
macOS
Swift
v1.2.0
日英UI
S3DV viewerは、記録された .s3dv 時系列3Dストリームを再生・検証する macOS ネイティブビューアです。WKWebView + three.js (r180) によるバッチ描画で、1ドローコール/アリーナのレンダリングを実現しています。
フレーム完全提示 (Frame-complete presentation)
負荷が高い場合でも、1つ1つのフレームを確実に描画してから次のフレームに移る設計です。受信パケットは即座に適用せず受信箱にバッファし、描画tick内で順序どおりに完全適用してから1フレームとして提示します。途中で予算を使い切った場合は中間フレームを落とし、後続の完全な状態だけを提示するため、途切れた帧(スナップショット半分適用など)が表示されることはありません。
- 提示フレームは常にパケット境界の完全なシーン状態 — 適用途中の状態は表示されません
- 負荷時はロード時間をとり、フレームを落とす — 1描画tickの適用予算(既定6 ms)内で適用し、超過分は次の完全状態へ折り畳み
- テクスチャはデコード完了後に組み込み — 白飛びの未完成フレームを出さない
- 非表示ウィンドウでは到着時に即適用 — rAFが~1 Hzに抑制される隠蔽時はペース制御を無効化し、パケットの滞留を防ぐ
主な特徴
- パケット完全性: エンジン送信数とページ適用数が一致 (page packets == framesSent)
- バッチ描画: 1アリーナ = 1ドローコール。8,236チャンク → 10ドローコール程度に削減
- メモリ予算ガバナ: 常駐ジオメトリ予算超過時は古い/外側チャンクを退避
- クラッシュ安全性: WebContentプロセス終了を検知して自動復帰(最大2回)
- CLI制御: UNIXソケット経由で
s3dvctlから全操作 (open/pause/step/seek/speed/presentation/applybudgetms/bench/screenshot/wait/quit) - 設定: 提示モード(frameComplete/immediate)・適用予算(1–50 ms)をライブ切替
ダウンロード
GitHub Releasesからアプリバンドルをダウンロードできます。ad-hoc署名(Apple公証なし)のため、初回起動時に「システム設定 > プライバシーとセキュリティ」からの許可が必要です。
ドキュメント
- README (操作・設定・CLI)
- 設計と検証 (研究リポジトリ)
- CLI リファレンス (研究リポジトリ)
検証結果 (v1.2.0)
| 項目 | 結果 |
|---|---|
| swift test (回帰テスト) | 45 / 45 パス |
| verify_app.sh (フルマトリクス) | 7 / 7 PASS |
| verify_cli.sh (CLI全コマンド) | 21 / 21 PASS |
| パケット一致 (1.27 GB GT ストリーム) | 24,494 / 24,494 (100%) |
| コンソール ERROR | 0 件 |
| リーク (10周) | -0.46 MB/周 (5 MB/周未満) |
開発者
折田悠希 (おりたゆうき / Yuki_Orita) · GitHub · X (旧Twitter) · Studio Rizi
オープンソース (MIT License)。バグ報告・告知用: Discord