手册版本
v2026.04.17.1
发布日期 2026-04-17
下载 PDF
3D Viewer¶
页面目标¶
帮助你理解当前版本 3D 视图的适用范围、可用操作和现实边界。
当前 3D 的适用范围¶
3D Viewer 目前只对 KiCad 板文件 生效：
- 支持：
*.kicad_pcb - 不支持：
DSN、ODB++、SES、普通制造包等其他输入格式
如果当前打开的不是 KiCad 板，3D 会直接显示明确提示，而不是展示空白场景。
进入 3D 后会发生什么¶
- 系统开始构建 3D 场景。
- 你会看到阶段化加载反馈，例如：
Prepare / Metadata / Scene / Meshes - 准备完成后，系统会自动执行一次适配当前板范围的视角。
当前可用操作¶
- 切换到
Top / Bottom / Isometric Fit- 复制
Scene info
这些动作既可以通过右键菜单使用，也会同步驱动当前 3D 相机状态。
与 Workbench 的联动¶
当你处于 3D 且当前文档是 KiCad 时，Workbench 的 Visibility 区域会额外出现 3D 小节，允许你调整：
- Board Surface：只看顶面，或让所有当前可见层共同参与板面显示
- Show proxy bodies：当真实元件 3D 模型缺失时，是否显示 fallback proxy geometry
使用建议¶
- 先用 3D 看整体，再回到 2D 做精确定位与导出。
- 如果你在 3D 里看到 issue 数量增加，可以先复制
Scene info方便后续排查。 - 3D 适合看板面、层面与空间感，不适合作为当前版本的最终导出视图。
常见问题¶
为什么 3D 提示“只支持 KiCad”？¶
因为当前代码里 3D 场景加载器会先检查源路径是否以 .kicad_pcb 结尾；不是 KiCad 时会直接进入 unsupported 状态。
3D 里的元件为什么有时像简化模型？¶
这通常是 proxy body。当前实现允许在缺少可渲染元件模型时，使用 fallback 几何占位；你可以在 Workbench 的 3D 小节里切换其显示状态。
3D 能直接导出吗？¶
当前不支持直接从 3D 发起导出。请回到 2D 再执行导出。