如何将欧拉旋转Y轴分量归零且保持3D杆指向不变？

在Unity/C#处理物理传感器数据可视化时，遇到四元数相关的3D数学问题：

• 有一个“杆”对象，旋转状态用欧拉向量(x,y,z)表示，其中Y轴对应滚转角（roll）
• 需求：将欧拉向量的Y分量设为0，同时自动调整X、Z分量，保证杆的指向完全不变（仅改变滚转角，滚转角本身无需关注）
• 示例：未旋转的杆、旋转参数为(0,90,90)的杆、旋转参数为(90,0,0)的杆，三者指向完全相同，仅滚转角存在差异

当前运行代码（带滚转角） #

这段代码能正确可视化X、Z轴的旋转，但存在需要消除的滚转角（直接将Y设为0会破坏X、Z轴的旋转效果）：

public Transform armTransform;
private Quaternion defaultArmRotation;
private Quaternion armOffset;
private Vector3 armOffsetEuler;
private bool isArmOffset = false;

// ... 省略其他业务代码 ...

float dataX = parsedXValue;
float dataY = parsedYValue;
float dataZ = parsedZValue;

// 从磁力计数据创建向量
Vector3 magnetField = new Vector3(dataX, dataY, dataZ);

// 归一化向量
magnetField.Normalize();

// 根据调整后的欧拉角计算四元数旋转
Quaternion rotation = Quaternion.LookRotation(magnetField, Vector3.up);

// 首次设置初始偏移
if (!isArmOffset)
{
    armOffsetEuler = defaultArmRotation.eulerAngles - eulerAngles;
    armOffset = Quaternion.Inverse(rotation) * defaultArmRotation;
    isArmOffset = true;
}

Vector3 newEulerAngles = eulerAngles + armOffsetEuler;

// 应用偏移到当前旋转
Quaternion adjustedRotation = rotation * armOffset;

// 将旋转应用到游戏对象
armTransform.rotation = adjustedRotation;

尝试的无Y轴旋转方法（存在局限） #

这个方法强制Y分量为0，但Z值仅能返回180、-180或0，无法满足通用场景需求：

public Vector3 GetXZRotationWithoutY(Vector3 eulerRotation)
{
    // 将欧拉角转换为四元数
    Quaternion rotation = Quaternion.Euler(eulerRotation);

    // 获取右向和前向向量
    Vector3 right = rotation * Vector3.right;
    Vector3 forward = rotation * Vector3.forward;

    // 计算新的欧拉角
    float xAngle = Mathf.Atan2(forward.y, forward.z) * Mathf.Rad2Deg;
    float zAngle = Mathf.Atan2(right.y, right.x) * Mathf.Rad2Deg;

    return new Vector3(xAngle, 0, zAngle);
}

核心思路：保留杆的前向指向，同时约束其向上向量在XY平面内（彻底消除Y轴滚转），再重新计算对应的X、Z欧拉角。

算法步骤 #

1. 从原旋转中提取杆的前向向量（forward），这是需要严格保留的指向
2. 计算约束后的向上向量：将原向上向量投影到XY平面（置Z分量为0后归一化）；若投影后向量长度接近0（说明原向上向量接近Z轴），则用默认的Vector3.up替代
3. 使用Quaternion.LookRotation，传入保留的前向向量和约束后的向上向量，得到无滚转的四元数
4. 将该四元数转换为欧拉角，强制Y分量为0（处理浮点精度误差）

实现代码 #

public Vector3 RemoveRollRotation(Vector3 originalEuler)
{
    // 将原欧拉角转为四元数，提取方向向量
    Quaternion originalRot = Quaternion.Euler(originalEuler);
    Vector3 forward = originalRot * Vector3.forward;
    Vector3 originalUp = originalRot * Vector3.up;

    // 将向上向量投影到XY平面，消除Z分量
    Vector3 constrainedUp = new Vector3(originalUp.x, originalUp.y, 0f).normalized;

    // 处理边界情况：原向上向量接近Z轴，投影后向量几乎为0
    if (constrainedUp.magnitude < 0.01f)
    {
        constrainedUp = Vector3.up;
    }

    // 创建无滚转的旋转四元数
    Quaternion noRollRot = Quaternion.LookRotation(forward, constrainedUp);
    Vector3 noRollEuler = noRollRot.eulerAngles;

    // 强制Y分量为0，消除浮点精度带来的微小误差
    noRollEuler.y = 0f;

    return noRollEuler;
}

代码说明 #

• 严格保留原旋转的前向方向，确保杆的指向完全不变
• 通过约束向上向量到XY平面，彻底消除Y轴滚转
• 处理了边界异常情况，避免归一化操作出错
• 最终返回的欧拉角Y分量为0，X、Z分量自动适配以维持指向

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