SuperAPI AI 工具集

blender-syntax-nodes

设计与创作

查看项目

更新于 10-15 22:17

技能介绍

用途:通过 Python 脚本与 bpy 构建和修改 Blender 的节点树,适用几何节点、着色器节点、合成器节点,也涉及第三方 Sverchok 节点。

主要能力:讲解 NodeTree、Node、NodeLink、NodeSocket 的结构;创建节点组并定义接口;创建与连接节点;为材质与合成器建树;把几何节点组挂到对象的修改器上;设置未连接插槽默认值;增删节点与连线;用 NodeFrame 组织布局、静音或隐藏节点;并给出常见节点类型字符串与插槽类型表。

必要用法与版本差异:Blender 4.0+ 组接口用 group.interface.new_socket(),不再使用 inputs.new()/outputs.new();4.1+ 支持 interface.new_panel()。合成器在 3.x/4.x 用 scene.node_tree,5.0+ 改用 scene.compositing_node_group。5.0+ 起 scene.use_nodes 已弃用。节点插槽必须按名称访问,不要用索引。

关键限制:修改器输入使用自动生成的标识符(如 Socket_N),不能按插槽名设置,必须遍历 interface.items_tree 找到对应 identifier。渲染进行中不要修改节点树,否则会因渲染线程竞态导致崩溃。混色节点 4.0+ 用 ShaderNodeMix 取代 ShaderNodeMixRGB;着色器名称 3D_UNIFORM_COLOR 在 4.0+ 已移除,应使用 UNIFORM_COLOR。

适用场景:以代码方式批量生成节点组、程序化几何、材质与合成流程,以及跨 Blender 版本的脚本迁移。具体收费、安装步骤与官方文档之外的信息暂未提供。