咨询Forge是否支持线性爆炸功能及自定义实现方案

嘿Chris，刚好我之前折腾过类似的Forge装配体自定义爆炸需求，来给你唠唠解决方案！

一、有没有现成的线性爆炸代码？ #

Forge原生的爆炸功能确实主打径向模式，没有直接提供一键沿指定轴线性爆炸的API，但我们可以基于Viewer的核心API自己实现这个逻辑，下面是我整理的可复用代码示例：

基础版：沿指定轴线性爆炸所有零部件 #

// 假设viewer是已经初始化完成的Forge Viewer实例
function linearExplodeAlongAxis(axis = new THREE.Vector3(1, 0, 0), distanceFactor = 50) {
    // 获取装配体根节点
    const rootNode = viewer.model.getRoot();
    if (!rootNode) return;

    // 收集所有可爆炸的叶子节点（单个零部件）
    const leafNodes = [];
    rootNode.enumNodeChildren(node => {
        if (node.isLeaf()) leafNodes.push(node);
    }, true);

    // 给每个零部件分配沿轴的爆炸位移
    leafNodes.forEach((node, index) => {
        const fragIds = node.getFragIds();
        fragIds.forEach(fragId => {
            const fragProxy = viewer.model.getFragmentList().getFragmentProxy(fragId);
            fragProxy.getAnimTransform(); // 获取当前部件的变换数据

            // 按零部件顺序递增位移，保证沿轴排列的层次感
            const displacement = axis.clone().multiplyScalar(distanceFactor * (index + 1));
            fragProxy.position.add(displacement);

            fragProxy.updateAnimTransform(); // 应用新的位移
        });
    });

    // 刷新视图让爆炸效果生效
    viewer.impl.sceneUpdated(true);
}

// 使用示例：沿X轴爆炸，每个部件间隔50单位
linearExplodeAlongAxis(new THREE.Vector3(1, 0, 0), 50);

二、进阶优化：打造更灵活的自定义爆炸功能 #

如果需要更贴合轴基装配体的精准控制，可以做这些优化：

1. 基于装配层级的爆炸（子部件相对父部件偏移） #

适合螺栓、垫圈这类有层级关系的组件，让子部件跟着父部件的位置偏移：

function recursiveLinearExplode(node, axis, distanceFactor, currentLevel = 0) {
    if (node.isLeaf()) {
        const fragIds = node.getFragIds();
        fragIds.forEach(fragId => {
            const fragProxy = viewer.model.getFragmentList().getFragmentProxy(fragId);
            fragProxy.getAnimTransform();
            // 按部件在装配树的层级分配位移
            const displacement = axis.clone().multiplyScalar(distanceFactor * currentLevel);
            fragProxy.position.add(displacement);
            fragProxy.updateAnimTransform();
        });
    } else {
        // 递归处理子节点，层级+1
        node.enumNodeChildren(childNode => {
            recursiveLinearExplode(childNode, axis, distanceFactor, currentLevel + 1);
        }, true);
    }
}

// 使用示例：沿Y轴按层级爆炸
recursiveLinearExplode(viewer.model.getRoot(), new THREE.Vector3(0, 1, 0), 30);

2. 支持爆炸收拢功能 #

先保存部件的初始位置，需要恢复时直接还原：

// 存储每个部件的初始变换数据
const initialTransforms = new Map();

// 提前保存初始状态（建议在模型加载完成后调用）
function saveInitialComponentPositions() {
    const rootNode = viewer.model.getRoot();
    rootNode.enumNodeChildren(node => {
        if (node.isLeaf()) {
            node.getFragIds().forEach(fragId => {
                const fragProxy = viewer.model.getFragmentList().getFragmentProxy(fragId);
                fragProxy.getAnimTransform();
                initialTransforms.set(fragId, {
                    position: fragProxy.position.clone(),
                    rotation: fragProxy.rotation.clone(),
                    scale: fragProxy.scale.clone()
                });
            });
        }
    }, true);
}

// 收拢爆炸效果
function collapseExplosion() {
    initialTransforms.forEach((transform, fragId) => {
        const fragProxy = viewer.model.getFragmentList().getFragmentProxy(fragId);
        fragProxy.getAnimTransform();
        fragProxy.position.copy(transform.position);
        fragProxy.rotation.copy(transform.rotation);
        fragProxy.scale.copy(transform.scale);
        fragProxy.updateAnimTransform();
    });
    viewer.impl.sceneUpdated(true);
}

3. 指定特定部件爆炸 #

可以通过部件名称或ID过滤，只对螺栓、垫圈这类目标组件应用爆炸：

function explodeTargetComponents(targetNames, axis, distanceFactor) {
    const rootNode = viewer.model.getRoot();
    rootNode.enumNodeChildren(node => {
        if (node.isLeaf() && targetNames.includes(node.name)) {
            node.getFragIds().forEach(fragId => {
                const fragProxy = viewer.model.getFragmentList().getFragmentProxy(fragId);
                fragProxy.getAnimTransform();
                const displacement = axis.clone().multiplyScalar(distanceFactor);
                fragProxy.position.add(displacement);
                fragProxy.updateAnimTransform();
            });
        }
    }, true);
    viewer.impl.sceneUpdated(true);
}

// 使用示例：只爆炸名称包含"Bolt"和"Washer"的部件
explodeTargetComponents(["Bolt", "Washer"], new THREE.Vector3(0, 0, 1), 40);

三、关键注意事项 #

• 一定要在模型几何加载完成后执行爆炸逻辑，建议监听Autodesk.Viewing.GEOMETRY_LOADED_EVENT事件
• 代码中的位移单位是Viewer内部单位，需要和你的模型实际单位（比如毫米）做对应换算
• 如果需要基于装配约束轴爆炸，可以解析Model Derivative返回的装配关系数据，从中提取约束方向

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