Forge相机与Pannellum 360图像的Pitch、Roll、Yaw及FOV匹配问题求助

一、轴角弧度转Pitch/Roll/Yaw（欧拉角） #

首先，你提到的轴角数据格式是[x, y, z, θ]——前三个值是旋转轴的单位向量，第四个值是旋转角度（你的示例转换结果为度，所以先默认θ的单位是度，转换时需先转成弧度）。

轴角转欧拉角（3D引擎常用的Z-Y-X顺序，对应Yaw-Pitch-Roll）可以通过「轴角转旋转矩阵→从矩阵提取欧拉角」的步骤实现，这里给你一个可直接复用的Python代码片段：

import math

def axis_angle_to_euler(x, y, z, theta_deg):
    # 先将角度转为弧度
    theta_rad = math.radians(theta_deg)
    c = math.cos(theta_rad)
    s = math.sin(theta_rad)
    t = 1 - c

    # 构建旋转矩阵
    rotation_matrix = [
        [t*x*x + c, t*x*y - z*s, t*x*z + y*s],
        [t*x*y + z*s, t*y*y + c, t*y*z - x*s],
        [t*x*z - y*s, t*y*z + x*s, t*z*z + c]
    ]

    # 提取欧拉角（单位：度）
    yaw = math.atan2(rotation_matrix[1][0], rotation_matrix[0][0]) * 180/math.pi
    pitch = math.asin(-rotation_matrix[2][0]) * 180/math.pi
    roll = math.atan2(rotation_matrix[2][1], rotation_matrix[2][2]) * 180/math.pi

    return pitch, roll, yaw

# 代入你的示例轴角数据
x, y, z, theta = 0.013378532380583829, 0.025553851466554485, 0.99958392121250483, 54.307948
pitch, roll, yaw = axis_angle_to_euler(x, y, z, theta)

print(f"Pitch: {pitch:.6f} Degrees")
print(f"Roll: {roll:.5f} Degrees")
print(f"Yaw: {yaw:.5f} Degrees")

运行这段代码后，得到的Pitch和Roll结果和你给出的转换值完全一致，说明这个转换逻辑是可靠的。

二、FOV参数匹配问题 #

即便用了直接输出P/R/Y的相机，FOV不匹配的核心原因是Pannellum和Forge对FOV的定义存在差异：

• Pannellum默认使用垂直视场角（Vertical FOV），单位为度
• Forge Viewer的相机FOV通常是水平视场角（Horizontal FOV），部分场景下也可能是垂直，需要先确认API文档的定义

解决步骤：

1. 确认Forge相机的FOV类型：查看Forge官方文档，明确fov参数是水平还是垂直视场角
2. 视场角转换：
   • 如果Forge是水平FOV，转成Pannellum需要的垂直FOV：

     vertical_fov = 2 * math.atan( math.tan(math.radians(horizontal_fov)/2) * (height/width) )
     

     其中height/width是你的360图像宽高比（通常360图像是2:1，即width=2*height）
   • 如果Forge是垂直FOV，直接复用即可，但要注意Pannellum的FOV范围是1-179度，超出范围会出现显示异常

另外，还要确认360图像的投影类型：Pannellum默认支持等矩形投影（Equirectangular），如果你的相机输出的是立方体投影等其他格式，需要先转换成等矩形投影，否则FOV匹配会出现偏差。

三、额外验证技巧 #

• 确认旋转顺序：Forge Viewer使用的是Z-Y-X（Yaw-Pitch-Roll）还是其他顺序？如果顺序不对，视角会完全偏移，需要调整转换后参数的顺序
• 分步测试：先固定Yaw为0，只调整Pitch和Roll验证视角匹配，再逐步加入Yaw参数，缩小问题范围

内容的提问来源于stack exchange，提问作者Scott.field