SuperAPI AI 工具集

blender-rigging

设计与创作

查看项目

更新于 10-16 05:05

技能介绍

用途:面向 Blender 的骨架(armature)与角色绑定工作,提供类型化的绑定工具。适合在创建骨架或骨骼、绑定网格、添加约束、创建形态键或驱动器,以及在兼容骨架之间复制姿态/动作数据时加载。保存与加载可复用姿态建议用 blender-pose-library,关键帧编辑与烘焙用 blender-animation,仅在检查过本类型化接口后再考虑 blender-scripting。

主要能力:inspect_armature 可读取层级、骨架空间静止数据、当前局部通道、求值后的骨架空间姿态矩阵以及有界的约束摘要;max_bones 限制返回骨骼数量,bone_names 可指定子集。蒙皮摘要需显式传入 mesh_names 且该网格带有指向该骨架的 Armature 修改器;确定性顶点索引前缀只是采样,除非 scan_complete 为 true。摘要覆盖变形骨骼顶点组,不涵盖包络变形,也不构成动画质量证明。set_pose_bone_transforms 可批量应用绝对的、相对静止姿态的局部 RNA 通道。

用法与限制:位置使用场景单位,欧拉角使用弧度,单位四元数为 [w, x, y, z]。欧拉顺序默认 XYZ,输入四元数则选择 QUATERNION。省略的通道保持不变,欧拉与四元数输入互斥。每个缩放分量绝对值至少 1e-6,所有数值分量必须有限且绝对值不超过 1e6。每个骨骼与输入在修改前都会校验。更新使用数据 API,不改变选择、模式、帧、约束或关键帧,支持无头 Blender,需先退出骨架编辑模式。依赖求值后会核对通道回读与请求值或其精确 32 位浮点表示,并返回实际值与求值矩阵。约束可能使求值姿态不同于请求的局部通道;覆盖通道的驱动器会导致失败。应用或回读失败时会尝试恢复全部原始通道,错误中会明确报告 rolled_back 与 rollback_errors,重试前应先检查骨架。关键帧请另行使用 blender-animation。