汇编实现3D立方体旋转时四元数乘法功能异常排查

核心问题定位 #

你的问题根源是四元数相乘的逻辑错误（顺序或分量计算），导致组合旋转时引入了意外的平移分量，看起来像是立方体随机移动。单轴旋转正常说明QuatAngleAxis和QuatMultVec的基础逻辑没问题，但四元数乘法的错误会破坏旋转的纯变换特性，最终让顶点变换偏离预期。

排查与修复步骤 #

1. 确认四元数乘法顺序 #

四元数乘法不满足交换律，相机旋转的组合顺序直接决定结果：

• 若需求是先绕Y轴（相机左右转向）再绕X轴（相机俯仰），正确的乘法顺序应为 Q_final = Q_x * Q_y（左乘，因为后续旋转需要叠加到之前的相机变换坐标系上）
• 若你写成Q_y * Q_x，会得到完全不同的旋转路径，甚至因计算错误引入平移。

2. 核对QuatMult的实现公式 #

四元数乘法的标准计算逻辑（q1 = (w1,x1,y1,z1)，q2=(w2,x2,y2,z2)，乘积q=q1*q2）：

; 伪代码示例，对照你的汇编实现检查
w = w1*w2 - x1*x2 - y1*y2 - z1*z2
x = w1*x2 + x1*w2 + y1*z2 - z1*y2
y = w1*y2 - x1*z2 + y1*w2 + z1*x2
z = w1*z2 + x1*y2 - y1*x2 + z1*w2

重点检查：

• 减法项的符号是否正确
• 寄存器赋值时有没有混淆分量顺序（比如x/z、y/x搞反）
• 浮点数运算的栈操作或寄存器使用是否正确（比如FPU的ST栈是否有溢出或未正确弹出）

3. 确保四元数归一化 #

组合旋转后的四元数必须保持单位长度，否则QuatMultVec会引入缩放甚至平移：

; 伪代码：归一化四元数
len = sqrt(w*w + x*x + y*y + z*z)
w = w / len
x = x / len
y = y / len
z = z / len

如果你的代码中没有这一步，多次旋转后四元数长度偏离1，顶点变换就会出现异常偏移。

4. 检查RotateVertices宏的变换流程 #

确保顶点变换是纯旋转，无额外平移：

• 顶点应先转换到相机坐标系（若需要），再应用四元数旋转，最后投影到屏幕
• 若宏中错误地将四元数的w分量当作平移量，或计算时误加了无关偏移，都会导致立方体“随机移动”

调试技巧 #

• 手动验证四元数乘积：用已知的Qx、Qy值（比如Qx是绕X转90度，Qy绕Y转90度），计算标准乘积，对比汇编代码的输出是否一致
• 拆分测试：固定X轴旋转角度为0，只保留Y轴旋转，确认立方体行为正常；再固定Y轴测试X轴，逐步叠加排查
• 监控顶点坐标：在变换前后打印顶点的三维坐标，查看是否出现非预期的偏移量

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