如何将四元数转换为极角/方位角 无滚转弧球相机实现方案

你当前用glm::quat(glm::vec3(phi, theta, 0))构造四元数时，GLM默认采用X->Y->Z的欧拉角旋转顺序：phi是绕X轴的俯仰角（对应你说的极角），theta是绕Y轴的方位角，Z轴滚转分量固定为0。在这个无滚转的强约束下，只要极角phi不触发±90度的万向锁死区，两个角度的解是唯一的，不存在无穷多解的问题。

具体实现可以直接用GLM内置的转换函数，额外做范围归一化和边界钳制即可：

#include <glm/gtc/quaternion.hpp>
const float PI = glm::pi<float>();

glm::vec3 euler_out = glm::eulerAngles(rotation);
// 还原极角phi，钳制范围避开万向锁点
float phi = glm::clamp(euler_out.x, -PI/2.0f + 1e-4f, PI/2.0f - 1e-4f);
// 还原方位角theta，归一化到[-PI, PI]区间
float theta = std::fmod(euler_out.y + PI, 2*PI);
if (theta < 0) theta += 2*PI;
theta -= PI;

如果触发万向锁（phi接近±90度，相机正对正上方/正下方），方位角theta会失去物理意义，这是欧拉角本身的表示缺陷，不是转换逻辑的问题，常规弧球相机交互一般都会把phi钳制在±89度左右，完全可以避开这个问题。

完全可以抛弃欧拉角状态，仅维护四元数旋转、轨道中心点、轨道距离三个核心状态实现弧球相机，从根源上避免欧拉角转换、万向锁的问题，交互手感也更顺滑，是目前工业界更常用的实现方案。

核心实现逻辑如下：

• 核心状态不需要存任何欧拉角：
  • glm::vec3 orbit_center：相机环绕的目标点
  • float orbit_distance：相机到目标点的距离
  • glm::quat cam_rotation：相机的旋转四元数，初始值为单位四元数
• 鼠标拖动旋转逻辑：不要修改角度值，直接根据鼠标位移生成局部旋转四元数，和当前相机旋转叠加即可
• 每帧通过四元数直接计算相机位置、视图矩阵，不需要中间角度转换

核心代码参考：

// 相机核心状态
glm::vec3 orbit_center = glm::vec3(0.0f);
float orbit_distance = 6.0f;
glm::quat cam_rotation = glm::quat(1.0f, 0.0f, 0.0f, 0.0f); // 单位四元数初始值
const float rotate_sensitivity = 0.005f;

// 鼠标移动事件回调，传入鼠标帧位移dx、dy
void OnMouseMove(double dx, double dy) {
    float rot_x_amt = static_cast<float>(-dy) * rotate_sensitivity;
    float rot_y_amt = static_cast<float>(-dx) * rotate_sensitivity;

    // 左右拖动：绕世界空间Y轴生成旋转四元数
    glm::quat y_rot = glm::angleAxis(rot_y_amt, glm::vec3(0.0f, 1.0f, 0.0f));
    // 上下拖动：绕相机当前局部右轴生成旋转四元数
    glm::vec3 local_right = cam_rotation * glm::vec3(1.0f, 0.0f, 0.0f);
    glm::quat x_rot = glm::angleAxis(rot_x_amt, local_right);

    // 叠加旋转，注意乘法顺序保证无额外滚转
    cam_rotation = y_rot * cam_rotation * x_rot;
    // 归一化四元数，消除累计浮点误差
    cam_rotation = glm::normalize(cam_rotation);
}

// 生成视图矩阵
glm::mat4 GetViewMat() {
    // 计算相机世界位置：从目标点向旋转后的负Z方向退orbit_distance距离
    glm::vec3 cam_pos = orbit_center + cam_rotation * glm::vec3(0.0f, 0.0f, -orbit_distance);
    // 取旋转后的局部Up向量，保证视角无滚转
    glm::vec3 local_up = cam_rotation * glm::vec3(0.0f, 1.0f, 0.0f);
    return glm::lookAt(cam_pos, orbit_center, local_up);
}

这个方案的优势：

• 全程无欧拉角参与，不存在角度转换多解、万向锁问题
• 旋转逻辑稳定，浮点误差仅需每帧归一化四元数即可消除，长期运行不会出现视角偏移
• 扩展简单：滚轮缩放直接修改orbit_distance，中键平移直接修改orbit_center即可
• 即使后续需要获取phi、theta做UI展示，也可以通过第一部分提到的转换方法随时提取，因为整个旋转逻辑没有引入滚转分量，提取结果和纯欧拉角方案完全一致

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