如何通过Forge Viewer获取.max文件的图层数据？

核心原因 #

viewer.impl.getLayerRoots()是Viewer的内部私有API，返回的是Viewer渲染层面的图层结构，和3ds Max原生图层并非直接映射。另外，模型通过Model Derivative API转换时，如果未配置保留图层选项，原始Max图层信息会丢失或被修改。

解决方案步骤 #

1. 确保转换时保留Max图层
   转换Max文件到SVF格式时，必须在转换请求中启用图层导出选项，示例请求Payload如下：

   {
     "input": { "urn": "你的模型URN" },
     "output": {
       "formats": [
         {
           "type": "svf",
           "views": ["3d"],
           "advanced": {
             "layer": { "export": true }
           }
         }
       ]
     }
   }
   

   如果之前未开启该选项，需要重新转换模型。

2. 使用公开API获取正确图层数据
   替换私有API，改用Viewer的公开方法获取图层：

   • 遍历所有图层节点：

     const layerNodes = viewer.model.getDocumentNode().getRoot().search({ type: 'Layer' });
     layerNodes.forEach(node => {
       console.log('图层名称:', node.name, '图层ID:', node.id);
     });
     

   • 新版本Viewer直接获取图层列表：

     const layers = viewer.model.getLayers();
     layers.forEach(layer => {
       console.log('图层名称:', layer.name, '图层可见性:', layer.isVisible());
     });
     

3. 映射Max原始图层与Viewer图层

   • 转换后的图层名称可能和Max原生名称略有差异（比如添加前缀），可通过对比name属性匹配对应关系。
   • 查看构件所属的原始Max图层：通过构件DBID获取属性，其中Layer字段对应Max原生图层名称：

     viewer.getProperties(yourDbId, (props) => {
       const maxLayer = props.properties.find(p => p.displayName === 'Layer');
       if (maxLayer) console.log('构件所属Max图层:', maxLayer.displayValue);
     });
     

4. 控制原始Max图层的可见性
   通过获取到的图层ID控制可见性：

   // 假设已获取目标图层的layerId
   viewer.setLayerVisibility(layerId, false); // 隐藏图层
   

额外注意事项 #

• 建议升级到最新版Forge Viewer，旧版本对Max图层的支持不完善。
• Max中部分图层可能因转换优化（如合并同类图层）被合并，若需完全保留原始结构，转换前需确保Max文件的图层未被自动合并。

内容的提问来源于stack exchange，提问作者B.z