nan
bbaa4bff46
- Added a new "Stretch Limit" parameter to the Depth Surface node, allowing for dynamic edge culling based on the ratio of original to projected edge lengths. - Updated the geometry processing to capture original edge lengths before projection and calculate current lengths after projection. - Implemented logic to delete edges and faces that exceed the stretch limit, ensuring cleaner topology. - Enhanced tests to validate the new functionality, including scenarios for edge retention and deletion based on stretch limits. - Updated documentation and node assets to reflect the new parameter and its implications on geometry processing.
2.3 KiB
2.3 KiB
1. 锁定节点接口与求值行为
- 1.1 扩展 Cutout 节点资产结构测试，规定
Stretch Limit仅连接O Image Depth Surface、位于 Options、Factor 范围为0–1且默认值为0，并运行对应tests/test_cutout_objects.py用例 - 1.2 增加真实 Blender 求值测试，覆盖 Stretch Limit 为
0时保留完整表面、正阈值分别保留阈值内 Edge 与删除超限 Edge，并验证调整 Depth Scale 会实时改变拉伸判断 - 1.3 增加剔面后拓扑测试，验证
Face Count == 0的 Edge 与 Point 被删除，而仍属于一个 Face 的开放边界保留
2. 构建 Depth Surface 拉伸剔面
- 2.1 在
O Image Depth Surface的 Set Position 前以 Point Domain 捕获 Edge Vertices Distance 原值，并在 Set Position 后以同一个 Field 直接求当前值 - 2.2 比较
原始距离 / 当前距离 < Stretch Limit，以POINT / ALL删除超限位置及相邻拓扑；默认0自然关闭剔面 - 2.3 在 Stretch Culling 后按 Edge Neighbors Face Count 删除纯线 Edge，再按 Vertex Neighbors Face Count 删除无 Face Point，并将清理后的几何交给 Thickness 与 Smooth
- 2.4 在外层
O Image Cutout暴露并只向 Depth Surface 分支连接Stretch Limit，保持其他 Shape、现有 Mesh Island Cleanup 和 Depth 数据输入不变
3. 节点资产、文档与验证
- 3.1 更新
tools/node_assets/validate_cutout.py，构建并验证src/anyimage/assets/O_AnyImage.blend的接口、节点顺序、无重叠与几何求值 - 3.2 更新 Cutout 用户说明、
docs/internals/operators/cutout-tool.md与docs/internals/node-assets.md，说明 Stretch Limit 的零值关闭、剩余比例语义和松散拓扑清理 - 3.3 运行 Cutout 定向测试、
uv run build_node与uv run pytest，确认 Vector Depth RGB/Validity Alpha、其他三个 Shape 和现有 Cleanup 没有回归
4. 按最终节点接法修正
- 4.1 移除 Projected Position Capture 与 Sample Index，以同一个 Edge Vertices Distance Field 分别捕获原值并在完整 XYZ Set Position 后直接求当前值
- 4.2 将拉伸 Delete Geometry 改为 Point Domain，并保留后续纯线 Edge 与孤立 Point 清理
- 4.3 同步结构与真实求值测试、节点资产和文档，运行 OpenSpec、节点构建及全量测试