如何在Forge Viewer V7中用欧拉角实现相机真北朝向同步及边界设置

1. 相机指向真北并基于北向值同步旋转 #

Forge Viewer的相机默认基于模型自身坐标系，要指向真北需先处理模型与地理北向的偏移，再调整相机姿态：

• 获取模型北向偏移：若模型来自Revit等BIM工具，可从模型属性或viewer.model.getData().placementWithOffset中读取模型坐标系相对真北的旋转偏移（通常为yaw轴角度，单位弧度）。
• 调整相机至真北：利用Viewer的navigation模块设置相机yaw角，结合模型北向偏移计算目标角度：

  // 假设已从模型数据中获取到真北偏移量northOffset（弧度）
  const northOffset = ...;
  // 目标北向对应的yaw值（Viewer中yaw绕Y轴旋转）
  const targetYaw = desiredNorthAngle - northOffset;
  // 保持当前俯仰、倾斜，仅调整转向
  const currentPitch = viewer.navigation.getPitch();
  const currentRoll = viewer.navigation.getRoll();
  viewer.navigation.setView(
    viewer.navigation.getPosition(),
    viewer.navigation.getTarget(),
    currentPitch,
    targetYaw,
    currentRoll
  );
  

• 同步北向旋转：若有实时北向值更新，计算当前yaw与目标yaw的差值，调用viewer.navigation.rotate(deltaYaw, 0)完成同步。

2. 边界设置与欧拉角同步相机 #

边界设置 #

Viewer支持通过navigation.setBoundary设置相机移动边界，限制相机在指定范围内操作：

// 基于模型包围盒创建边界，可自定义扩展/缩小
const modelBounds = viewer.model.getBoundingBox();
const customBounds = modelBounds.expandByScalar(10); // 向外扩展10单位
viewer.navigation.setBoundary(customBounds);

// 取消边界限制
// viewer.navigation.setBoundary(null);

该方法会限制相机位置、缩放等操作不会超出边界框范围。

欧拉角同步相机 #

Viewer支持直接通过pitch（俯仰，绕X轴）、yaw（转向，绕Y轴）、roll（倾斜，绕Z轴）同步相机姿态，使用navigation模块的方法即可：

// 已知外部传入的欧拉角（单位弧度）
const pitch = ...;
const yaw = ...;
const roll = ...;

// 方式1：一次性设置位置、目标点与姿态
const position = viewer.navigation.getPosition();
const target = viewer.navigation.getTarget();
viewer.navigation.setView(position, target, pitch, yaw, roll);

// 方式2：单独设置各角度
viewer.navigation.setPitch(pitch);
viewer.navigation.setYaw(yaw);
viewer.navigation.setRoll(roll);

注意：若外部欧拉角基于Z轴向上的坐标系，需先转换为Viewer的Y轴向上坐标系，调整角度对应关系后再传入。

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