基于Vulkano的GLTF查看器使用cgmath四元数旋转致场景拉伸求助

这问题我之前做Vulkan相机控制的时候也碰到过，大概率是四元数使用不当或者相机变换顺序错误导致的，咱们一步步来排查解决：

最常见的原因：四元数未归一化 #

cgmath的四元数如果经过多次旋转累积，会逐渐失去单位长度，这会导致后续的矩阵变换隐含缩放效果，直接表现就是模型拉伸变形。解决方法很简单：每次更新旋转后都对四元数做归一化。

示例代码：

use cgmath::{Quaternion, Vector3};

// 假设这是你的相机旋转变量
let mut camera_rot: Quaternion<f32> = Quaternion::identity();

// 处理鼠标旋转输入后，立即归一化
camera_rot = camera_rot.normalize();

检查相机变换的顺序 #

相机的平移和旋转顺序直接影响最终的视图效果，错误的顺序会导致旋转时相机绕世界原点而非自身坐标系转动，出现模型突然跑到相机附近的情况。

正确的逻辑应该是：先旋转相机（确定朝向），再基于旋转后的本地坐标系进行平移。因为相机的前后左右移动是相对于当前朝向的，而不是世界空间的方向。

比如相机的视图矩阵计算，应该先构建旋转矩阵，再将平移向量转换到旋转后的空间，最后取逆得到视图矩阵：

use cgmath::{Matrix4, Vector3, Transform};

// 相机位置
let camera_pos: Vector3<f32> = Vector3::new(0.0, 0.0, 5.0);
// 已归一化的旋转四元数
let camera_rot: Quaternion<f32> = ...;

// 先将旋转转换为矩阵
let rot_matrix = Matrix4::from(camera_rot);
// 构建相机的变换矩阵：先旋转，再平移
let camera_transform = Matrix4::from_translation(camera_pos) * rot_matrix;
// 视图矩阵是相机变换的逆矩阵
let view_matrix = camera_transform.invert().unwrap();

或者更简洁的方式，用look_at函数，但要确保目标点是相机当前朝向的前方：

// 相机的前向向量（基于旋转后的本地空间）
let forward = camera_rot * Vector3::unit_z();
// 相机的上向量
let up = camera_rot * Vector3::unit_y();
// 构建视图矩阵
let view_matrix = Matrix4::look_at_rh(camera_pos, camera_pos + forward, up);

避免欧拉角转换带来的万向锁问题 #

如果你是先将四元数转回欧拉角（Yaw/Pitch/Roll），修改后再转成四元数，很容易触发万向锁（就是你说的90-180度附近的异常）。正确的做法是直接用四元数累积旋转，跳过欧拉角的中间转换。

示例：处理鼠标旋转输入

const ROT_SENSITIVITY: f32 = 0.001;

// 鼠标移动的delta值（x是水平移动，y是垂直移动）
let delta_x: f32 = ...;
let delta_y: f32 = ...;

// 生成绕Y轴（左右转，Yaw）的四元数
let yaw_rot = Quaternion::from_axis_angle(Vector3::unit_y(), delta_x * ROT_SENSITIVITY);
// 生成绕X轴（上下转，Pitch）的四元数
let pitch_rot = Quaternion::from_axis_angle(Vector3::unit_x(), delta_y * ROT_SENSITIVITY);

// 累积旋转：注意顺序，先Yaw再Pitch，基于相机本地空间
camera_rot = yaw_rot * camera_rot * pitch_rot;
// 立即归一化
camera_rot = camera_rot.normalize();

// 额外：限制Pitch角度，防止相机翻转（避免接近90度时的异常）
let pitch = camera_rot.to_euler().1;
if pitch > 1.5 || pitch < -1.5 {
    // 超过限制，重置Pitch到边界值
    let (yaw, _, roll) = camera_rot.to_euler();
    camera_rot = Quaternion::from_euler(yaw, 1.5, roll).normalize();
}

最后验证视图矩阵的传递 #

确保在Vulkano的渲染流程中，视图矩阵正确传递给着色器，没有被错误的缩放或转换。比如在着色器中，模型矩阵、视图矩阵、投影矩阵的乘法顺序是proj * view * model，不要搞反。

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