如何用Viewer3D.js初始化对齐2D图纸并解决缩放/单位问题

问题1：图纸基准线未对齐 #

可通过为每份2D图纸设置独立变换矩阵实现基准线对齐。Aggregated View支持为单个加载节点配置平移变换，具体操作：

• 获取到图纸对应的bubble后，用THREE.Matrix4创建平移矩阵，将图纸移动到目标基准位置
• 在view.setNodes()前，直接修改bubble.placementTransform，或后续调用view.setNodeTransform(bubble.dbId, matrix)动态调整

示例代码片段：

.then(bubbles => {
    // 示例：将第二份图纸沿X轴平移1000单位以对齐基准线
    const translateMatrix = new THREE.Matrix4().makeTranslation(1000, 0, 0);
    if (bubbles[1]) {
        bubbles[1].placementTransform = translateMatrix;
    }
    view.setNodes(bubbles);
    view.viewer.loadExtension('Autodesk.DocumentBrowser');
    viewer = view;
});

问题2：图纸缩放比例校正 #

针对单份图纸的尺寸误差，通过缩放变换矩阵修正比例：

1. 计算缩放因子：目标尺寸/当前错误尺寸 = 910.0 / 943.8 ≈ 0.9642
2. 创建缩放矩阵并应用到对应图纸模型

示例代码片段：

.then(bubbles => {
    // 示例：校正第二份图纸的X轴缩放比例
    const scaleFactor = 910.0 / 943.8;
    const scaleMatrix = new THREE.Matrix4().makeScale(scaleFactor, 1, 1);
    if (bubbles[1]) {
        // 若需同时平移，可将平移与缩放矩阵相乘：translateMatrix.multiply(scaleMatrix)
        bubbles[1].placementTransform = scaleMatrix;
    }
    view.setNodes(bubbles);
    // 后续代码...
});

问题3：单位转换（英寸→毫米） #

解决单位问题有两种简便方式：

• 缩放转换：利用1英寸=25.4毫米的换算关系，将英寸单位的图纸缩放25.4倍，同时确保其他图纸统一为毫米单位
• 加载时指定单位：若提前知晓图纸单位，可在加载模型的配置参数中指定，但已加载模型更适合用缩放矩阵调整

示例代码（缩放转毫米）：

.then(bubbles => {
    // 示例：将第一份英寸单位的图纸转换为毫米
    const inchToMm = 25.4;
    const unitMatrix = new THREE.Matrix4().makeScale(inchToMm, inchToMm, 1);
    if (bubbles[0]) {
        bubbles[0].placementTransform = unitMatrix;
    }
    view.setNodes(bubbles);
    // 后续代码...
});

注意事项 #

• 矩阵运算顺序：建议先执行缩放再执行平移，矩阵乘法需按平移矩阵.multiply(缩放矩阵)的顺序
• 可通过viewer.model.getModelSpaceBoundingBox()获取模型边界盒，辅助计算平移、缩放参数
• 变换操作需在view.setNodes()前完成，或通过view.setNodeTransform()动态调整已加载节点

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