OpenCADStudio文件格式实战手册:DWG/DXF跨版本转换与STL、STEP、OBJ导入导出清单

OpenCADStudio文件格式实战手册:DWG/DXF跨版本转换与STL、STEP、OBJ导入导出清单

【免费下载链接】OpenCADStudioA CAD application built with Rust — 2D/3D drawing, DWG/DXF support, and GPU-accelerated rendering项目地址: https://gitcode.com/gh_mirrors/op/OpenCADStudio

OpenCADStudio 是一款用 Rust 构建的开源 CAD 软件,原生读写 DWG/DXF 图纸文件,支持从 R14 到 2018 的全部版本目标,并可导入 OBJ 网格、导出 STL 与 STEP AP203 三维数据。本文整理它的文件格式能力清单、跨版本保存目标选择和一条命令完成 DWG/DXF 转换的实操步骤,帮你快速建立完整的图纸交换工作流。

支持格式一览表:哪些格式能读、哪些格式能写

OpenCADStudio 的 2D/3D 绘图核心与桌面端、浏览器版共用同一套读写引擎,不需要依赖任何在线转换服务。官方格式支持矩阵如下(来自 README.md):

一句话记忆:DWG/DXF 是"主场",OBJ 是"进口",STL/STEP 是"出口"。

DWG/DXF 跨版本保存:R14 到 2018 版本目标清单

当图纸需要发给使用旧版本 AutoCAD 的同事时,保存目标版本就很重要。OpenCADStudio 提供7 个版本保存目标:

• R14(AutoCAD 2000 之前的经典格式)
• R2000 / 2004 / 2007 / 2010 / 2013 / 2018

保存为 DXF 或 DWG 时都可以显式指定目标版本,文件头部版本随之改写,下游软件无需额外转换。

⚠️实战避坑:官方验证通道(DWG → DXF 往返校验)以2000 版本为基准。R14 的 DWG 虽然可以写出并重新打开,但 R14 的 DWG → DXF 路径可能产生与根字典脱节的对象字典,导致布局归属失效。自动化审计(audit)和带校验的保存(save_verified)会拒绝这类"假绿色"输出——交付前务必让save_verified通过。这条规则记录在 docs/automation/native.md。

一条命令完成 DWG/DXF 版本转换:无界面批量导出

除了图形界面,OpenCADStudio 的桌面构建内置了一个一次性的命令行转换器,适合批量图纸版本降级/升级场景(参见 docs/automation/native.md):

OpenCADStudio --export 输入.dwg 输出.dxf

规则很简单:

1. 输出文件扩展名决定格式——.dxf写 DXF,其他扩展名按文档自身版本写 DWG;
2. 加--target-version R14(或2000、2004、2007、2010、2013、2018)可显式指定目标版本;
3. 退出码含义:0成功、1输入/输出失败、2目标版本非法——非常适合写进 CI 脚本判断成败。

另外,--serve提供无窗口的 JSON 行协议通道,可在完全没有显示器的机器上批量打开、审计、保存图纸,细节见 docs/automation/README.md。

OBJ 导入实战:把多边形网格带进 CAD 图纸

拿到第三方模型(如 3D 扫描、打印件数据)时,用 OBJ 导入即可把它并入当前图纸:

• 解析顶点位置、法线与三角/四边形面,四边形自动拆成两个三角形;
• 坐标轴自动转换:OBJ 是 Y 向上,软件世界坐标 Z 向上,导入时自动旋转 +90°,方向不会"躺倒";
• 多对象文件只导入第一个对象/组,保持几何干净。

导入逻辑位于 src/io/obj.rs,网格随后与内核实体一样参与 GPU 加速渲染和三维编辑。

STL 与 STEP 导出清单:3D 模型如何对外输出

三维模型(拉伸、旋转、放样、布尔运算等生成的实体)有两种标准输出:

两个实用提示:

• STL 导出会为每个三角面计算其自身平面法线,而不是直接用平滑顶点法线,避免小三角面法线方向漂移(见 src/io/stl.rs);
• STEP 导出采用"每个三角面一个封闭壳"的简化编码——文件比最优编码更大,但任何支持 AP203 的 CAD 系统都能导入,通用性优先(见 src/io/step.rs)。

备份与恢复:BAK、SV$ 与测量点导入

跨版本工作之外,文件层面的"安全网"也别忽略:

• BAK备份文件和SV$自动保存文件可直接打开,崩溃后先找回最近状态;
• LandXML支持导入CgPoint测量点,方便把测绘数据带入图纸;
• CSV可提取实体属性数据,做报表或批量核对;
• 桌面端还可把布局或选中几何打印为 PDF,配套 CTB/STB 打印样式表控制出图颜色(打印样式资源见 assets/plotstyles/)。

相关文件与文档索引

想深入看源码或写自动化脚本,从这里入手:

• 读写模块总目录:src/io/
• OBJ 导入器:src/io/obj.rs
• STL 导出器:src/io/stl.rs
• STEP AP203 导出器:src/io/step.rs
• 无头转换与自动化协议:--export、--serve、--mcp三种入口,见 docs/automation/native.md
• 自动化 API 完整规格:docs/automation/API-SPEC.md

收尾建议:日常图纸交换用 2018 或 2013 目标;对接老系统时降到 2000(R14 谨慎使用);3D 打印走 STL,跨 CAD 交换走 STEP AP203,第三方模型用 OBJ 导入——记住这张清单,OpenCADStudio 的文件工作流就覆盖齐全了。

【免费下载链接】OpenCADStudioA CAD application built with Rust — 2D/3D drawing, DWG/DXF support, and GPU-accelerated rendering项目地址: https://gitcode.com/gh_mirrors/op/OpenCADStudio