3Dビューワーでアノテーションが多数ある場合、背面判定（Raycast）処理がパフォーマンスのボトルネックになります。本ドキュメントでは、採用した改善手法について説明します。
アノテーションの背面判定には、各アノテーションに対してRaycast（光線とメッシュの衝突判定）を実行する必要があります。この処理は以下の理由で重くなります：
- メッシュの全頂点との衝突判定が必要
- アノテーション数に比例して計算量が増加
- 毎フレーム実行すると60FPSの維持が困難
解決策: Idle時のみRaycast実行#
カメラが停止した時のみRaycast処理を実行 する方式を採用しました。
動作フロー#
実装詳細#
2段階の判定処理#
Raycast処理自体も最適化しています：
第1パス（軽量） : Frustum判定 + カメラ前後判定
- 視野外のアノテーションを早期に除外
- 計算コストが低い
第2パス（重い） : Raycast判定
- 第1パスを通過したアノテーションのみ対象
- メッシュとの衝突判定を実行
メリット#
| 項目 | 従来方式 | 最適化後 |
|---|
| Raycast頻度 | 毎フレーム or 15フレームごと | カメラ停止時のみ |
| ドラッグ中の負荷 | 高い | ほぼゼロ |
| 背面判定の正確性 | 常に正確 | 停止後に正確 |
制限事項#
- カメラ移動中は背面判定が更新されないため、一時的に不正確な表示になる可能性があります
- ただし、停止後すぐに更新されるため、実用上は問題ありません