Files
AnyImage/openspec/changes/unify-mask-cut-depth/tasks.md
nan c62ec2cd48 Refactor depth surface handling and unify depth sampling rules
- Removed the `always_vertex` parameter from `build_surface_camera` to streamline depth sampling for cutouts and ensure consistent behavior across depth plane and panorama.
- Updated depth sampling logic to ensure that all free boundary points, including the original frame of the depth plane, use neighboring face depth instead of their own texture sampling.
- Adjusted the depth mask deletion process to operate on faces rather than points, eliminating the need for additional cleanup of dangling edges.
- Ensured that the cutout rules are consistently applied across all relevant nodes, removing exceptions and simplifying the logic.
- Updated tests to verify the new behavior, ensuring that cutout points follow the depth of adjacent faces and that the original frame maintains its depth sampling.
- Refactored geometry handling in multiple depth-related nodes to improve clarity and maintainability.
2026-09-16 16:30:56 +08:00

2.3 KiB
Raw Blame History

1. 共享相机采样

  • 1.1 在 build_surface_camera 内部求值 edge_boundary_field 得到切口边界,删除 always_vertex 参数,让切口点与 Depth Split 切边走同一条深度替换路径
  • 1.2 为 build_surface_camera 增加可选排除字段并施加在切口边界上:被排除的点保持自身采样
  • 1.3 更新 build_surface_camera 的 docstring,说明切口取相邻面深、射线方向不变、排除字段的语义

2. 三个组接入

  • 2.1 O Image Depth Plane:去掉 always_vertex 用法,外框与切口同规则,不再传排除字段
  • 2.2 O Image Depth Panorama:去掉 always_vertex 用法,不传排除字段
  • 2.3 O Image Depth Cutout:去掉局部 outline 变量与 always_vertex 传参,确认轮廓与切边仍由内建规则覆盖
  • 2.4 确认 O Image Relief Plane、Cutout 创建入口与材质接线未受影响
  • 2.5 delete_invalid_points 改为 delete_invalid_faces:Delete Geometry 用 FACE 域,去掉残留边的第二次删除
  • 2.6 O Image Depth Plane:取消外框例外,build_surface_camera 去掉排除字段,全部自由边界点取相邻面采样

3. 测试

  • 3.1 Plane:在无效侧写入与有效侧相差一个数量级的深度,断言 mask 切口点跟随相邻面深、不出现尖刺
  • 3.2 Panorama:在无效侧写入差异距离,断言切口圈径向距离跟随相邻有效面
  • 3.3 断言切口点保持自身射线方向(Plane 相机横纵坐标不变、Panorama 经纬方向不变)
  • 3.4 重写 test_valid_only_deletes_invalid_points_and_wire_edges 中「删剩点是原几何子集」的断言,改为「切口取相邻面深」,保留 Depth Mask 关闭时逐位不变的对比
  • 3.5 断言 Plane 原画幅外框保持自身采样深度,以及不存在相邻保留面的自由点输出坐标有限
  • 3.6 运行 uv run pytest(至少覆盖 tests/tools/nodes/test_depth_relief_planes.py、test_boundary_depth.py、test_depth_surface_split.py、test_image_depth_panorama.py)

4. 资产与收尾

  • 4.1 运行 uv run node-group build,确认节点资产构建与校验通过、Capture Attribute 为零
  • 4.2 检查源码与测试中不再有 always_vertex 及旧路径引用,确认最终差异只涉及本次范围