SuperAPI AI 工具集

blender-syntax-modifiers

设计与创作

查看项目

更新于 10-16 06:17

技能介绍

用途:在 Blender 中通过 Python 脚本操作修改器(Modifier),包括添加、配置、删除、应用修改器,以及读取几何节点(Geometry Nodes)输入。

主要能力:提供修改器类型选择参考(如 ARRAY、BOOLEAN、SOLIDIFY、SUBSURF、MIRROR、BEVEL、NODES、DECIMATE、ARMATURE、SHRINKWRAP 等),并给出 AEC 场景常用修改器对照。包含添加修改器、删除修改器、应用修改器、通过依赖图读取求值后网格、配置几何节点输入、重排修改器等代码模式,以及阵列、布尔、实体化等常见操作示例。

必要用法与限制:应用修改器前必须处于 Object Mode,可用 bpy.ops.object.mode_set(mode='OBJECT') 切换;Blender 4.0+ 应用修改器需使用 context.temp_override(),字典覆盖会报 TypeError;读取修改器后结果应使用 obj.evaluated_get(depsgraph).to_mesh(),并在 try/finally 中调用 to_mesh_clear() 避免内存泄漏;几何节点输入标识符为自动生成的 Socket_N,需通过 modifier.node_group.interface.items_tree 查找,不能假设与名称一致;求值后的网格为只读,应修改原对象。

版本差异:Blender 3.x 与 4.0+ 在上下文覆盖、几何节点接口 API、输入标识符命名、modifier_move_to_index 可用性、bmesh.from_object() 与 BVHTree.FromObject() 的 depsgraph 参数要求等方面存在差异。

适用场景:建筑与工程(AEC)中的重复构件、墙体开洞、墙体厚度、参数化组件等脚本化建模任务。

限制:资料未提供安装命令、收费信息或具体运行环境要求,暂未提供。