Autodesk Forge Viewer小地图：如何用globalOffset实现多模型对齐？

你遇到的问题是因为官方小地图扩展（Autodesk.AEC.Minimap3DExtension）没有自动同步主视图中每个模型的globalOffset设置，以下是几个可行的解决方案：

方案1：模型加载后手动同步小地图偏移 #

在每个模型加载完成后，获取其globalOffset并应用到小地图中的对应模型实例上：

// 等待小地图扩展加载完成
viewer.addEventListener(Autodesk.Viewing.EXTENSION_LOADED_EVENT, (event) => {
  if (event.extensionId === 'Autodesk.AEC.Minimap3DExtension') {
    const minimapExt = viewer.getExtension('Autodesk.AEC.Minimap3DExtension');
    // 监听模型几何加载完成事件
    viewer.addEventListener(Autodesk.Viewing.GEOMETRY_LOADED_EVENT, (modelEvent) => {
      const targetModel = modelEvent.model;
      const globalOffset = targetModel.getGlobalOffset();
      // 找到小地图场景中对应的模型对象
      const minimapModel = minimapExt.minimapScene.getObjectById(targetModel.id);
      if (minimapModel) {
        // 主视图的globalOffset是反向偏移模型，小地图需设置为负的偏移值
        minimapModel.position.set(-globalOffset.x, -globalOffset.y, -globalOffset.z);
        // 更新小地图相机范围以适配所有模型
        minimapExt.fitToView();
      }
    });
  }
});

方案2：Monkey Patch小地图扩展的模型加载逻辑 #

通过覆盖小地图扩展的onModelLoaded方法，让它自动处理模型的偏移：

// 获取已加载的小地图扩展
const minimapExt = viewer.getExtension('Autodesk.AEC.Minimap3DExtension');
// 保存原始方法
const originalOnModelLoaded = minimapExt.onModelLoaded;
// 重写方法
minimapExt.onModelLoaded = function(model) {
  // 执行原始逻辑
  originalOnModelLoaded.call(this, model);
  // 应用globalOffset到小地图模型
  const globalOffset = model.getGlobalOffset();
  const minimapModel = this.minimapScene.getObjectById(model.id);
  if (minimapModel) {
    minimapModel.position.set(-globalOffset.x, -globalOffset.y, -globalOffset.z);
    this.fitToView();
  }
};

这种方式无需重复监听每个模型的加载事件，后续加载的所有模型都会自动同步偏移。

方案3：使用全局偏移（仅适用于统一偏移场景） #

如果所有模型需要应用相同的全局偏移，可以使用viewer.setGlobalOffset()替代每个模型单独设置globalOffset，这种方式下小地图会自动同步全局偏移：

// 设置全局偏移
viewer.setGlobalOffset({ x: refX, y: refY, z: refZ });
// 加载模型时无需再设置单个模型的globalOffset
viewer.loadDocumentNode(doc, docNode);

注意事项 #

• 操作小地图场景前必须确保扩展已完全初始化，避免出现minimapScene未定义的情况。
• 若小地图中模型对象的ID与主视图模型ID不匹配，可以遍历minimapExt.minimapScene.children来查找对应模型的Mesh或Group对象。
• 修改偏移后调用fitToView()能确保小地图相机自动适配所有模型的位置。

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