docs: explain 3D renderer panel and BVH ownership boundaries

This commit is contained in:
2026-11-12 20:51:29 +08:00
parent 3db8b13768
commit f0bfbc9fc1
3 changed files with 21 additions and 0 deletions
+2
View File
@@ -258,11 +258,13 @@ impl Index {
/// 检查索引覆盖的网格数量是否与场景相符;缺失缓存时允许重建。
// View 在查询前用它选择缓存或临时构建;不验证顶点或 world 变换,几何改变后须由快照层重建。
pub fn matches(&self, meshes: usize) -> bool {
// 仅为缺失/长度失配提供快速判断,不是网格内容指纹;相同数量下改 world/顶点仍须由不可变快照生产方重建。
self.bounds.len() == meshes
}
/// 用包围盒筛出射线候选;索引查询按进入距离排序,精确三角形求交在调用方完成。
// View::pick 消费排序候选,再逐三角形求交与裁剪;本函数不检查相机 near/far。
pub fn ray(&self, ray: Ray) -> Vec<(f32, usize)> {
// 此处遍历后一次性返回全部盒候选;View::pick 对排序结果做精确求交和距离提前停止,不是让 BVH 直接返回最近表面。
// 空树的栈为空;显式栈避免查询递归,先测分支包围盒,未命中时整棵子树跳过。
let mut stack: Vec<_> = self.root.into_iter().collect();
// 收集 (盒进入参数, 原实例下标),遍历结束后统一排序以支持 pick 的距离提前终止。