Forge Viewer中modelToSheetTransform位置映射异常问题排查

以下是针对单张图纸映射错误的具体排查方向和解决方法：

• 核对Sheet GUID匹配准确性
  确认传入的sheetGuid与aecData.viewports中对应图纸的GUID完全一致，包括大小写、字符格式。部分场景下图纸导出或上传后GUID可能发生变化，可通过打印所有视口的sheetGuid值，逐一对比找到匹配的视口对象，避免因GUID不匹配导致取错视口数据。

• 修正单位缩放计算逻辑
  原代码使用viewer.model.getUnitScale()获取3D模型单位缩放，但图纸可能存在独立的单位设置，导致缩放比例偏差。建议改用视口内置的单位信息手动转换：

  const aecData = await Autodesk.Viewing.Document.getAecModelData(
      viewer.model.getDocumentNode()
  );
  const viewport = aecData.viewports.find(
      (v: any) => v.sheetGuid === sheetGuid
  );
  // 基于视口的模型/图纸单位计算缩放比例
  const modelUnit = viewport.modelUnit;
  const sheetUnit = viewport.sheetUnit;
  const unitScale = Autodesk.Viewing.Private.units.convert(1, modelUnit, sheetUnit);
  modelToSheetTransformMatrix = Autodesk.AEC.AecModelData.get3DTo2DMatrix(
      viewport,
      unitScale
  ).clone();
  

• 检查视口数据完整性
  打印出错图纸对应的viewport对象，重点查看modelToSheetTransform矩阵参数，对比正常图纸的视口矩阵，若矩阵值存在明显异常（如平移量、缩放系数偏离合理范围），则可能是该视口数据损坏，需重新生成图纸与3D视图的关联视口。

• 验证API调用参数
  确认get3DTo2DMatrix方法是否存在未传入的可选参数，部分特殊视图场景可能需要额外传入视图方向、裁剪信息等参数，可通过查看API内部实现确认参数要求。

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