SuperAPI AI 工具集

blender-physics

设计与创作

查看项目

更新于 10-16 08:35

技能介绍

该工具集用于在 AI 辅助下组装和调整 Blender 物理场景,提供带类型的动力学操作。主要能力按域划分:刚体(add_rigid_body、set_rigid_body_properties、remove_rigid_body、list_rigid_bodies、set_rigid_body_world_settings、bake_rigid_body_simulation、clear_rigid_body_bake);刚体约束(add/remove/list_rigid_body_constraint);软体(add_soft_body_modifier、set_soft_body_settings);布料(add_cloth_modifier、set_cloth_settings);碰撞(add_collision_modifier、set_collision_settings);力场(add/remove/list_force_field);粒子系统(add_particle_system、set_particle_system_settings、list_particle_systems);缓存与烘焙(bake_simulation、clear_simulation_cache、get_simulation_status、list_simulation_modifiers)。另提供 Mantaflow 流体(add_fluid_modifier、set_fluid_settings)、Dynamic Paint(add_dynamic_paint_modifier、set_dynamic_paint_settings、add_dynamic_paint_surface、list_dynamic_paint_surfaces),以及粒子头发、子级与实例化(set_particle_hair、set_particle_children、set_particle_instance、bake_particle_system)。

用法与限制:域设置放在 modifier.domain_settings,set_fluid_settings 需单独传 domain_settings 对象,仅 DOMAIN 修改器暴露该块;分辨率用 resolution_max,resolution_divisions 自 Blender 2.82 起已移除。fluid_type 为 NONE 时域、流、效应器设置块为 None,设定类型后才出现。Mantaflow 无 OBSTACLE/INFLOW/OUTFLOW 类型,改设 fluid_type 为 FLOW 并配置 flow_behavior 与 flow_type;障碍物用 EFFECTOR 且 effector_type='COLLISION'。未生效的设置会记入 message 与 not_applied(skipped 为别名),传入不支持的属性名会被跳过而非拒绝,调用后应检查 not_applied。流体与 Dynamic Paint 烘焙不由这些工具提供,bake_simulation 只针对布料、软体与粒子点缓存,其他目标会被拒绝。烘焙与清缓存会改动场景状态,仅需探查时可传 dry_run=true。这些操作仅处理当前场景中匹配的缓存,需同时用对象名与修改器名缩小目标;无名称时选中所有受支持缓存,遇到不支持目标会在变更前中止预检。实际操作用到 context.temp_override,并保留场景范围与选择,返回前后缓存状态。原生烘焙为整体执行,不承诺中途取消。分类宜归为设计与创作。