3D编辑器中四元数与角度双向转换及旋转控制方案咨询

一、替代欧拉角的无奇点角度控制方案 #

• 增量式轴角度旋转：放弃将四元数全部分解为欧拉角的思路，让用户直接输入绕X/Y/Z轴的旋转增量。每次修改时，基于当前四元数做增量旋转——比如用户调整X轴角度，计算出角度变化值ΔX，然后用四元数乘法更新：新四元数 = 绕X轴转ΔX的四元数 * 当前四元数（乘法顺序根据你用的左手/右手坐标系调整）。这种方式完全避开奇点，因为不需要分解出完整的欧拉角，只做局部增量旋转。
• 四元数分量直接编辑（高级选项）：给专业用户开放四元数W/X/Y/Z分量的输入框，输入后自动做归一化处理（保证W²+X²+Y²+Z²=1）。普通用户可能看不懂，但适合需要精确控制的场景。
• 带历史跟踪的RPY分解：你当前的欧拉角分解会因Asin限制俯仰角范围导致万向锁。可以改用Atan2计算俯仰角，同时跟踪用户上一次输入的角度值——当接近奇点时，自动把偏航角的变化转移到滚转角上，保持操作的连贯性，避免角度跳变。

二、Unreal Engine与Unity的实现方式 #

Unreal Engine #

UE细节面板显示的是Roll-Pitch-Yaw角度，但内部用四元数存储。它解决奇点的核心是上下文感知的角度转换：当俯仰角接近±90°时，自动调整偏航角和滚转角的数值，让用户操作保持连贯。比如用户在俯仰角90°时调整偏航，UE会把这个旋转逻辑转移到滚转角上，不会出现角度突变。底层的FQuat::Rotator()函数会结合上一次的旋转状态，生成符合用户预期的欧拉角，而非单纯的数学分解结果。

Unity #

Unity的Transform组件显示欧拉角，但同样用四元数存储旋转。它的处理方式是动态调整显示的欧拉角数值：当旋转接近万向锁时，自动把用户的操作意图映射到其他轴的角度上，让用户感觉不到锁定。比如绕X轴转90°后再调整Y轴，Unity会将这个旋转转化为Z轴的旋转，同时保持显示的欧拉角符合用户操作逻辑。Quaternion.eulerAngles属性在获取时，会返回一组“最贴合用户操作习惯”的欧拉角，而非唯一的数学解；设置时则基于当前旋转做增量处理，避免万向锁。

三、现有代码的问题与改进 #

你当前的代码用Asin计算俯仰角，导致其被限制在-90°到90°，这就是万向锁的根源。下面是改进后的分解代码，通过跟踪历史角度保持连续性：

// 从四元数提取连续的RPY角度，避免万向锁跳变
public static Vector3 QuaternionToEuler(Quaternion q, Vector3 lastEuler)
{
    double qw = q.w, qx = q.x, qy = q.y, qz = q.z;

    // 计算滚转角（X轴）
    double sinr_cosp = 2 * (qw * qx + qy * qz);
    double cosr_cosp = 1 - 2 * (qx * qx + qy * qy);
    double roll = Math.Atan2(sinr_cosp, cosr_cosp);

    // 计算俯仰角（Y轴），接近奇点时复用历史偏航角保持连续
    double sinp = 2 * (qw * qy - qz * qx);
    double pitch;
    double yaw;
    if (Math.Abs(sinp) >= 1)
    {
        pitch = Math.PI / 2 * Math.Sign(sinp);
        // 把滚转角的变化转移到偏航角，保持操作连贯
        yaw = lastEuler.z + (roll - lastEuler.x);
    }
    else
    {
        pitch = Math.Asin(sinp);
        // 计算偏航角（Z轴）
        double siny_cosp = 2 * (qw * qz + qx * qy);
        double cosy_cosp = 1 - 2 * (qy * qy + qz * qz);
        yaw = Math.Atan2(siny_cosp, cosy_cosp);
    }

    return new Vector3((float)roll, (float)pitch, (float)yaw);
}

另外，在设置角度时，不要直接用欧拉角构造四元数赋值，改用增量旋转：比如用户修改了X轴角度，计算ΔX = 新角度 - 当前显示的X角度，然后用Quaternion.AngleAxis(ΔX, Vector3.right) * currentQuaternion更新四元数，彻底避开万向锁问题。

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