nan
31074bd511
- 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.
82 lines
4.5 KiB
Markdown
82 lines
4.5 KiB
Markdown
# 节点资产
|
||
|
||
## 构建节点资产
|
||
|
||
生产节点组由 `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 顺序与结构、未使用输出隐藏及几何求值；纯布局变更比较运算、默认值和实际连接，确认功能不变
|
||
|
||
```mermaid
|
||
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/` 检查。
|
||
|
||
```bash
|
||
uv run node-group build --blender "/path/to/blender"
|
||
uv run node-group build --skip-tests
|
||
```
|
||
|
||
脚本按 `--blender`、环境变量 `BLENDER_BIN`、项目 `.env`、`PATH` 的顺序查找 Blender。无法自动找到时，在项目根目录的 `.env` 中配置：
|
||
|
||
```dotenv
|
||
BLENDER_BIN="/absolute/path/to/blender"
|
||
```
|