为何四元数旋转仅半数时间正确朝向目标？附代码与视频

问题根源 #

你遇到的翻转问题来自两个核心原因：

1. float4x4(eye:center:up)生成的是视图矩阵（用于将世界空间转换到相机空间），而非物体的模型旋转矩阵，直接转换为四元数会导致朝向逻辑混淆；
2. 当物体位置与原点的连线和指定的up向量（[0,1,0]）共线时，lookAt矩阵无法生成唯一的正交旋转基，四元数转换时会出现旋转歧义，导致朝向翻转。

解决方案 #

直接基于物体指向原点的方向向量构建连续的旋转四元数，避免依赖lookAt矩阵，同时处理up向量共线的边界情况。以下提供两种可靠实现：

方法1：利用四元数方向转换（简洁版） #

mutating func calculateGizmo() {
    time += 0.03

    let position: float3 = [0,
                            cos(time * 0.7) * 4,
                            sin(time * 0.9) * 4]
    gizmo.position = position

    // 计算物体指向原点的目标方向
    let targetForward = normalize(float3(0, 0, 0) - position)
    // 定义模型本地前方向（根据你的模型调整，Metal默认常用-Z作为前向）
    let localForward = float3(0, 0, -1)

    // 生成从本地前向到目标方向的旋转四元数
    var rotation = simd_quatf(from: localForward, to: targetForward)

    // 修正Y轴朝向，避免翻转
    let currentUp = rotation.act(float3(0, 1, 0))
    if dot(currentUp, float3(0, 1, 0)) < 0 {
        rotation *= simd_quatf(angle: .pi, axis: localForward)
    }

    gizmo.transform.quaternion = rotation
}

方法2：手动构建正交旋转基（鲁棒版） #

mutating func calculateGizmo() {
    time += 0.03

    let position: float3 = [0,
                            cos(time * 0.7) * 4,
                            sin(time * 0.9) * 4]
    gizmo.position = position

    let forward = normalize(float3(0, 0, 0) - position)
    var referenceUp = float3(0, 1, 0)

    // 处理forward与referenceUp共线的边界情况
    if abs(dot(forward, referenceUp)) > 0.999 {
        referenceUp = float3(1, 0, 0)
    }

    // 构建正交的右、上向量
    let right = normalize(cross(forward, referenceUp))
    let up = normalize(cross(right, forward))

    // 生成旋转矩阵（Metal列优先格式）
    let rotationMatrix = float4x4(
        float4(right, 0),
        float4(up, 0),
        float4(-forward, 0), // 对应模型前向为-Z的情况，根据模型调整符号
        float4(0, 0, 0, 1)
    )

    gizmo.transform.quaternion = simd_quatf(rotationMatrix)
}

关键说明 #

• 两种方法都避免了lookAt矩阵的歧义问题，确保旋转连续无翻转；
• 注意调整localForward或旋转矩阵中forward的符号，匹配你的3D模型的本地朝向（比如部分模型可能用+Z作为前向）；
• 边界处理逻辑确保物体移动到Y轴正/负方向时，依然能保持正确的朝向。

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