Assimp加载模型X轴旋转90度后骨骼动捕数据映射异常排查

核心结论 #

你在最外层modelMatrix上叠加的X轴90度旋转，是导致手动映射动捕骨骼旋转出错的核心原因之一，不存在骨骼计算逻辑本身的玄学问题。
自带动画能正常播放的原因很简单：Assimp导入的内置动画所有关键帧变换，都是和模型原生坐标系完全绑定的，外层modelMatrix属于模型空间到渲染空间的整体变换，不会侵入骨骼层级内部的局部变换关系，所有骨骼的计算结果跟着外层矩阵做统一变换，自然显示正常。

具体错误原因 #

你手动传入动捕局部旋转时，没有做和外层旋转一致的坐标系基矢适配：
你加X轴90度旋转的本质，是把模型资产的原生坐标系（多数建模软件导出的资产为Y-up/Z-up、轴向和渲染API默认坐标系不匹配）转换到你当前渲染管线使用的观察坐标系。而动捕设备输出的关节旋转数据，是基于动捕自身的坐标系生成的，你直接把未做转换的旋转值塞给骨骼局部变换，相当于在错误的坐标轴基底下计算旋转，结果必然出错。

修复步骤 #

• 不要把X轴90度的修正旋转侵入骨骼层级内部：不要把这层旋转乘到骨骼偏移矩阵、根骨骼局部变换里，这层旋转永远只放在最外层的modelMatrix上，仅作为模型空间转世界/观察空间的全局变换，避免污染骨骼内部的父子变换链。
• 对动捕输入的局部旋转做统一坐标系转换：固定旋转矩阵R_x90就是你外层modelMatrix上叠加的那个X轴90度旋转矩阵，对每一段骨骼的动捕原始四元数旋转做基矢转换，公式为adjusted_bone_rot = R_x90 * raw_mocap_rot * inverse(R_x90)，转换后的旋转再赋值给对应骨骼的局部变换。
• 核对旋转数据的格式匹配：
  • 确认动捕输出的是关节局部旋转而非全局旋转，如果是全局旋转需要顺着骨骼父节点链逐层级乘父节点逆变换，转成骨骼局部空间旋转再使用
  • 动捕欧拉角转四元数时，严格匹配动捕数据的旋转顺规（比如常见的XYZ、ZYX顺规），顺规不匹配会导致旋转完全错乱
• 快速验证方法：提取内置动画某一帧的骨骼局部旋转值，和你手动映射同姿态下的旋转值做对比，如果三个轴分量存在固定的90度偏移，就说明坐标系转换没有做对。

你保留模型文件原始位置、缩放参数的操作是正确的，随意修改导入时的缩放、平移参数会额外引入不必要的变换误差。

内容的提问来源于stack exchange，提问作者Nahri