- Introduced new utility functions in common nodes for evaluating fields and capturing attributes. - Simplified volume field calculations in image depth cutout and panorama groups by utilizing new utility functions. - Enhanced readability and maintainability of the image depth cutout and panorama node groups by removing redundant code and improving function usage. - Adjusted default values for thickness and depth scale in image relief plane group for better user experience. - Improved handling of geometry attributes and connections in image depth plane group to streamline processing.
1.8 KiB
1.8 KiB
Why
几何节点中存在仅为传递中间字段而写入、读取命名属性的链路,增加节点数量和隐式依赖。现行节点资产规范以跨区域连线作为命名存储的依据,需要统一改为按字段求值上下文与数据生命周期选择传递方式。
What Changes
- 全面检查构建入口中的几何节点组及共享构建函数,沿几何链、字段链和外部消费者记录命名属性的存取域、求值时机与用途。
- 同一几何状态与等价求值域中的中间字段优先直连;显式保留必要的域转换,删除冗余存取及失去用途的清理节点和辅助函数。
- 需要固定变形前、拓扑变化前或分支源几何上的值时优先使用 Capture Attribute;需要按名称供材质、输入网格或其他消费者访问的属性继续使用命名属性。
- 调整受节点数量变化影响的构建接线,使用明确返回的节点或 socket 引用表达业务连接。
- 更新
AGENTS.md与docs/internals/node-assets.md的节点属性规范,按新规范统一整理节点连线。 - 更新相关测试,重建并验证
.blend资产,确认几何、UV、材质与修改器接口行为一致。
Capabilities
New Capabilities
无。本变更属于内部节点重构与开发规范调整,使用 skip_specs: true。
Modified Capabilities
无。保持现有公开接口和几何行为。
Impact
tools/nodes/common、tools/nodes/groups,重点是 Depth Surface、Depth Cutout 和 Panorama。tools/nodes/arrangement的现有布局能力与相关测试需验证能正确处理直连及匿名属性;仅在发现实际问题时修改。tests/tools/nodes、相关 Operator 与材质测试、src/anyimage/assets/O_AnyImage.blend。AGENTS.md、docs/internals/node-assets.md。