模型校准

模型校准用于将已加载模型移动、旋转或按两条线段对齐。模型 URL 必须与加载时使用的 URL 完全一致。

矩阵校准

viewer.engine?.applyCalibration({
  url: 'https://example.com/models/building-a/',
  matrix: [
    1, 0, 0, 0,
    0, 1, 0, 0,
    0, 0, 1, 0,
    0, 0, 0, 1
  ]
});

可调用 setCalibration()、applyCalibration()、getCalibrationMatrix() 和 clearCalibration()。

偏移与旋转

viewer.engine?.setModelCalibrationTransform({
  url: 'https://example.com/models/building-a/',
  offset: { x: 0, y: 0, z: 0 },
  rotation: { x: 0, y: 0, z: 0 },
  rotationOrder: 'XYZ'
});

使用 getModelCalibrationItems() 读取当前校准数据，使用 resetModelCalibration(url) 恢复该模型初始状态。校准变更可通过 calibration:changed 事件持久化。