SuperAPI AI 工具集

blender-geometry-nodes

设计与创作

查看项目

更新于 10-15 20:34

技能介绍

用途:为 Blender 几何节点提供类型化操作,覆盖创建几何节点组、把节点组挂载为网格修改器、设置修改器暴露的输入,以及检查程序化图形状态。低层通用节点图操作(如 list_nodes、connect_nodes、set_node_input)请改用 blender-shader-nodes。

主要能力:create_geometry_node_group 与 add_geometry_nodes_modifier 支持 template 参数。pass_through(默认,也可写 default):组内含 Geometry 输入、Geometry 输出以及 Group Input 到 Group Output 的连线,可直接扩展并挂载为修改器。empty:无插槽无节点的空组,需用 create_geometry_node_socket 自行添加。模板仅在创建组、或已有组仍无节点时应用,已创作的图不会被 get-or-create 重写。

返回值:create_geometry_node_group 返回组本身信息,包括 group_name、template、created、template_applied、node_count、link_count、interface_sockets、input_count、output_count。add_geometry_nodes_modifier 返回修改器分配信息,包括 object_name、modifier_name 及带 group_ 前缀的 group_name、group_template、group_created、group_template_applied;它不返回 node_count、link_count、interface_sockets。缺值不等于空接口,应改用 inspect_geometry_node_interface 读取插槽标识与方向,或用 evaluate_geometry_nodes_info 查看修改器输入及取值。

使用方式:用 inspect_geometry_node_interface 读取插槽标识、方向、基础默认值、组使用者数量与接口修订号。查询接口超过 256 项或文本字段超过 1024 字节会被拒绝。把精确的修订号传给 create/update/remove_geometry_node_socket;更新与删除须用返回的标识符而非可能歧义的标签。每次编辑后回读并使用新修订号,过期修订会在编辑前失败。创建支持 Geometry、Float、Int、Bool、Vector、Color、String 类型及双向。数值默认值须为有限值且在正负 1000000 内,向量三分量、颜色四分量,名称限 63 UTF-8 字节,描述与字符串默认值限 1024 字节。单个修改器的输入值用 set_geometry_node_modifier_input,改接口默认值不构成逐对象覆盖。

限制:接口编辑影响该组所有使用者;被链接或库覆盖的组会被这些修改类工具拒绝。删除插槽可能断开连线并丢弃逐实例输入。原生编辑开始后失败会提示可能已变更且不回滚,重试前先检查。修订号只覆盖接口布局、标签、方向、类型、描述与支持的基础默认值,不含求值后的几何、连线或逐修改器取值。面板增删改查、插槽类型替换、对象/材质/集合引用、菜单、字段域控制与区域仍不在本接口范围。图形信息工具不证明求值几何符合预期。实现基于 Blender 的 NodeTreeInterface API。