Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

RedRing アーキテクチャ構成

RedRing の幾何計算層とレンダリング層の構成について説明します。

🧱 ワークスペース構成

幾何計算層

現在の実装状況(2026年2月13日更新)

analysis → geo_foundation
                ↓
           geo_commons(共通定義)
                ↓
           geo_core(ブリッジ役)
            ↓    ↓
   geo_primitives  geo_nurbs(Foundation準拠)
            ↓         ↓
      geo_algorithms  geo_io
クレート責務現在の状態目標状態
analysis数値解析・線形代数・微積分✅ 実装済み✅ 完了
geo_foundation抽象型・トレイト定義(BasicTransform 等)✅ 実装済み✅ 完了
geo_commons共通定義・ユーティリティ(Foundation準拠)✅ 実装済み✅ 完了
geo_primitivesプリミティブ幾何専用(独自 Transform 実装)✅ 実装済み✅ 完了
geo_nurbsNURBS 幾何専用(Foundation パターン準拠)✅ 実装済み✅ 完了
geo_coreFoundation ブリッジ・交差判定基盤✅ 実装済み✅ 完了
geo_algorithms高レベル幾何アルゴリズム・Octree空間分割✅ 基本実装🔧 拡張中
geo_ioファイル I/O(STL/OBJ/PLY 等)📋 計画中📋 将来

主要な達成事項(2025年12月〜2026年2月)

  1. ✅ Phase 3完了(2025年12月21日): 衝突判定・交差判定機能実装
  2. ✅ geo_nurbs Foundation準拠(2026年1月): アーキテクチャ違反解消
  3. ✅ 形状可視化システム完成(2026年2月8日): 15形状GPU描画対応
  4. ✅ geo_commons Foundation準拠(2026年2月13日): Issue #222完了
  5. ✅ レガシーAPI移行完了(2026年2月13日): Issue #202 Phase 2完了

レンダリング層

redring ← stage ← render
       ↖ viewmodel
クレート責務状態
renderGPU 描画基盤(wgpu + WGSL)✅ 実装済み
stageレンダリングステージ管理✅ 実装済み
viewmodelビュー操作・変換ロジック✅ 基本実装
redringメインアプリケーション✅ 実装済み

🔄 移行ステータス (f64 Canonical Geometry)

項目状態説明
Vector/Point f64 化✅ 完了.value() 呼び出し不要
3D 基本プリミティブ抽出✅ 完了Foundation 統合型に統一
Foundation 責務分離✅ 完了Core/Extensions 分離による保守性向上
Legacy 削除フェーズ✅ 完了旧 Legacy* 型削除、CI で deprecated deny

詳細な移行履歴と予定は MIGRATION_VECTOR_F64.md の末尾「Core Role Realignment」を参照してください。

✅ 互換性ポリシー

  • すべての Legacy 型は削除されました。geo_primitives から f64 正準型をご利用ください。
  • CI で deprecated symbols が deny されるため、古い Legacy 型の使用はビルドエラーとなります。
  • f64 正準層では座標アクセサは全て f64 を返却し、距離/面積など測定量のみ Scalar (単位意味付け) を維持。

🧪 テスト戦略

  • f64 ベース幾何 (ベクトル / 点 / 方向 / 線分 / 平面 / 円) に最小ユニットテストを追加済み。
  • 今後: レガシー排除前に alias 経由 API の smoke test を追加予定。

🔗 関連ドキュメント