Files

nan 31074bd511 Add tests and implement boundary smoothing and cutout functionality

- Introduced tests for boundary smoothing in `test_boundary_smoothing.py`, verifying that smoothing reduces stair-step artifacts while preserving boundary integrity.
- Added tests for cutout boundary behavior in `test_cutout_boundary.py`, ensuring proper handling of boundary triangles and normal blending.
- Created `test_temporary_attributes.py` to check the cleanup of temporary attributes across depth modifier branches, ensuring no warnings are raised.
- Implemented point culling functionality in `test_validity.py`, confirming that invalid points are removed without affecting adjacent geometry.
- Developed boundary smoothing logic in `boundary_smoothing.py`, allowing for depth smoothing while maintaining edge integrity.
- Added cutout boundary management in `cutout_boundary.py`, including functions for removing boundary triangles and tapering thickness profiles.
- Implemented validity checks in `validity.py` to ensure proper deletion of invalid vertices and associated wire edges.

2026-09-11 20:37:20 +08:00

4.5 KiB

Raw Blame History

节点资产

构建节点资产

生产节点组由 uv run node-group build 构建到 src/anyimage/assets/O_AnyImage.blend

节点组文件在 tools/nodes/groups

节点组规则：

字段默认直接连接，多个消费者可复用同一输出；按消费位置的几何、域、类型和输入属性版本验证求值等价性
所有几何节点、嵌套组及测试辅助图禁止使用 Capture Attribute；构建定义和保存资产递归检查 Capture 为零
域转换使用 Evaluate on Domain 或明确域的采样节点表达；跨几何变化优先调整消费顺序或在源几何上采样，明确索引对应关系
Store Named Attribute 用于实际命名协议或仍需跨几何变化保存的最少数据，逐项明确名称、类型、域、Selection、写入阶段、消费者及必要性；内部临时属性使用专用名称，在最后消费者之后精确清理，保留 UV、用户属性和外部协议属性
Group Input 按区域重复放置，通过字段排列和必要的 Reroute 保持连线可读，隐藏未使用输出；存储须有数据生命周期依据
构建阶段通过明确的节点或 socket 引用接线
保留节点默认 name 和标题，不用 label 覆盖，不用 String 节点注解。Frame 仅用于确有包裹语义的区域
全接线的简单数学运算可折叠；需要阅读的常数、运算域和模式保持可见
修改器 Geometry Nodes 的输入 socket 默认使用 SINGLE
socket subtype 按业务语义设置：长度用 DISTANCE，0–1 比例用 FACTOR，0–100 用 PERCENTAGE；无对应范围语义时保留默认
接口或布局变更须验证 socket 顺序与结构、未使用输出隐藏及几何求值；纯布局变更比较运算、默认值和实际连接，确认功能不变

flowchart TD
    A[字段生产与消费] --> B{需要按名称访问}
    B -->|是| C[命名属性]
    B -->|否| D{目标上下文重新求值是否等价}
    D -->|是| E[字段直连并显式转换域]
    D -->|否| F[调整消费顺序或在源几何采样]
    F --> G{仍需保存源数据}
    G -->|否| E
    G -->|是| H[仅存储必要命名数据]
    H --> I[最后消费者后精确清理]

字段与临时属性

平滑循环按固定源位置查询原边界索引，并在当前边界网格上消费位置；拓扑不变的边界与影响权重直接求值。Depth Plane 由 UV 矩形判断原边界，Panorama 的闭合源球面以 False 表示原边界。

厚度构建使用源顶点索引排列构造网格，完成挤出与合并后按索引从源表面采样位置、厚度和法线。Depth Cutout 的中心、圆化、结构及膨胀字段在投影源表面求值。

属性	域 / 类型	写入与最后消费
`.o_anyimage_depth_cut`	CORNER / BOOLEAN	三个深度组在 Split Edges 前保存切分标记，供投影调整射线，投影后精确清理
`.o_anyimage_original_boundary`	POINT / BOOLEAN	Depth Cutout 在切分前保存任意输入轮廓，供切口平滑保护原边界，平滑后精确清理
`UVMap`	CORNER / FLOAT2	Image Plane 与 Panorama 的输出 UV，供材质读取
`o_normal_scale`	POINT 或 FACE / FLOAT	Cutout 输出法线掩码，Depth Cutout 合并背面与侧壁后统一写入，供形状和材质消费

资产清单

节点组	构建模块
`O Image Plane`	`image_plane.py`
`O Image Depth Plane`	`image_depth_plane.py`
`O Image Relief Plane`	`image_relief_plane.py`
`O Image Layer`	`image_layer.py`
`O Image Depth Layer`	`image_depth_layer.py`
`O Shadeless`	`shadeless.py`
`O Image Cutout`	`image_cutout.py`
`O Image Depth Cutout`	`image_depth_cutout.py`
`O Image Depth Balloon`	`image_depth_balloon.py`
`O Image Depth Panorama`	`image_depth_panorama.py`

构建资产脚本

tools/nodes/build.py 按依赖顺序构建资产，调用 arrangement/ 统一排列几何节点组后保存。common/ 提供共用构建函数，preview/ 导出交互预览。

保存后，check.py 在独立 Blender 进程中重新加载资产并做基本几何求值。接口、默认值和详细几何行为由 tests/ 检查。

uv run node-group build --blender "/path/to/blender"
uv run node-group build --skip-tests

脚本按 --blender、环境变量 BLENDER_BIN、项目 .env、PATH 的顺序查找 Blender。无法自动找到时，在项目根目录的 .env 中配置：

BLENDER_BIN="/absolute/path/to/blender"

4.5 KiB Raw Blame History Unescape Escape