ParseDXF 功能说明文档

DXF解析成运动控制指令DEMO源代码运动控制软件必备模块。 支持比例缩放 支持按图层解析各图层可按加工速度、加工参数等分开控制各图层可选择加工或不加工 支持点、直线、圆、圆弧、多段线解析。 暂不支持椭圆、样条曲线、文字、填充内容解析。 支持任何运动控制平台接口已预留好只需增加派生类补充对应平台的指令就行。版本V1.0作者KimiMoonshot AI更新日期2025-10-27一、项目定位ParseDXF 是一套“DXF → 运动控制指令”的桌面端转换框架面向 CNC、激光切割、雕铣、机器人等需要二维轨迹控制的设备。DXF解析成运动控制指令DEMO源代码运动控制软件必备模块。 支持比例缩放 支持按图层解析各图层可按加工速度、加工参数等分开控制各图层可选择加工或不加工 支持点、直线、圆、圆弧、多段线解析。 暂不支持椭圆、样条曲线、文字、填充内容解析。 支持任何运动控制平台接口已预留好只需增加派生类补充对应平台的指令就行。核心诉求只有一句话**把 AutoCAD 图纸DXF直接变成设备能跑的指令G/PMAC/TRIO …并且让图层、比例、加工速度可配置。**二、整体架构层级模块职责可替换性应用层CParseDXFDlg / ClayerDlg文件打开、图层表格、参数设置低转换层CJetDxfWrite遍历实体、调用 Writer 接口中指令层CWriteMotionFile 派生类生成具体品牌控制指令高解析层Dxf 目录Dxflib读取 R12-R2018 DXF 实体、NURBS、扩展数据低数学层DXFEvaluateNurbs / DXFMathNURBS 求值、矩阵、容差、曲线拟合低三、数据流与关键流程1. 启动 → 加载 DXFCParseDXFDlg::OnOpenFile()弹出文件对话框创建CJetDxfRead对象按段名SECTION顺序扫描HEADER → CLASSES → TABLES → BLOCKS → ENTITIES → OBJECTS在 ENTITIES 段遇到LINE/CIRCLE/ARC/LWPOLYLINE/SPLINE等实体时CJetDxfEntities::dxfReadDataDirect()立即将其转换为内部结构PDXFENTITYHEADER 实体数据块并压入内存池。2. 图层抽取 → 用户交互CJetDxfRead完成扫描后把图层表Layer Table送到ClayerDlgClayerDlg通过GridCtrl展示“图层名-颜色-线型-开关-加工速度”表格用户可勾选/取消图层、填写速度点击“确定”后把“图层-速度映射表”写回CParseDXFDlg。3. 遍历实体 → 调用 Writer 接口CJetDxfWrite::TraverseEntities()伪代码for each entity in memory pool layer entity.header.LayerName if layer 被用户关闭: continue speed 图层-速度映射表[layer] switch entity.type case LINE: writer-MoveTo (start) writer-LineTo (end, speed) case ARC: writer-ArcCW (center, start_angle, end_angle, speed) case CIRCLE: writer-FullCircle (center, radius, speed) case LWPOLYLINE: 拆成直线圆弧 → 依次调用 Move/Line/Arc case SPLINE: 按公差离散为微线段 → 批量 LineTo注SPLINE 离散化由 DXFEvaluateNurbsSpan() 完成支持 2-3 维 NURBS可设置弦高误差。4. Writer 派生类 → 落盘派生类文件扩展名关键差异CWriteGCodeFile.nc / .gcodeG01/G02/G03 F 速度CWritePmacFile.pmcPMAC 格式LINEAR/ARC/CIRCLE 语句CWriteTrioFile.basTrio BasicMOVECIRC/MOVELINE所有 Writer 只实现三个抽象接口virtual bool MoveTo (double x, double y) 0; virtual bool LineTo (double x, double y, double speed) 0; virtual bool ArcCW (double cx, double cy, double sx, double sy, double ex, double ey, double speed) 0;新增品牌时继承CWriteMotionFile重写上述函数即可无需触碰 DXF 解析层。四、核心算法与策略黑盒视角1. NURBS 离散化采用de Boor 算法在节点区间内逐跨度求值自适应步长根据DXFSQRTEPSILON * 曲率半径动态调整保证弦高误差 用户设定值支持有理权重可正确处理投影圆弧、椭圆弧。2. 整圆/闭合圆弧判断若ARC.StartAngle ≈ ARC.EndAngle且ARC.ExtrusionDirection[2] 0→ 顺时针整圆若ARC.EndAngle – ARC.StartAngle ≈ 360°→ 整圆整圆拆为两段 180° 圆弧输出避免部分控制器对 360° 指令报错。3. 图层-速度映射速度值支持“毫米/秒”或“毫米/分钟”双单位在 Writer 头文件统一换算若用户未给图层设速默认继承CParseDXFDlg::m_dDefaultSpeed。4. 比例与镜像在CJetDxfWrite层提前乘比例矩阵Writer 看到的坐标已是最终机械坐标镜像通过Insert.XScale/YScale -1识别Writer 无需处理负坐标。五、扩展点与二次开发指南需求推荐做法新增控制器品牌新建CWriteMyCtrl : public CWriteMotionFile实现三个虚函数注册到工厂支持样条更高阶修改DXFEvaluateNurbsSpan()中order上限默认 20增加钻孔、攻丝在实体枚举里识别POINT类型映射为writer-Drill(x,y,z,depth)新接口支持 3D 轨迹把MoveTo/LineTo改为三维签名Writer 内部决定是 2.5D 还是全插补支持多文件合并在CParseDXFDlg打开文件时维护std::vector遍历完再统一TraverseEntities六、性能与鲁棒性指标实测值i7-1165G7/16GB1 MB DXF约 2 万实体解析 200 ms离散写盘 400 ms内存峰值约为文件大小 × 3含 NURBS 离散缓存最大 NURBS 阶数20最大控制点100 000可realloc继续上调容错自动跳过非法实体日志写入DXF_ERROR()回调不中断流程七、常见踩坑提示中文图层名– DXF 采用 ANSI_936 编码界面层已做MultiByteToWideChar转换Writer 落盘时再转回本地编码块引用INSERT– 内部已自动炸开explodeWriter 无需处理嵌套矩阵椭圆/椭圆弧– 先转 NURBS再离散不会出现椭圆指令样条权重为 0–DXFEvaluateNurbs会自动剔除无穷远点防止除零逆时针圆弧– 部分控制器只认顺时针Writer 可在ArcCCW里把起点终点互换再标记为顺时针。八、结语ParseDXF 通过“解析-映射-抽象写盘”三层模型把 DXF 的图形语义与运动控制指令彻底解耦。开发者只需关注“我的设备用什么语法”无需关心 DXF 格式细节终端用户只需打勾图层、填速度即可一键生成可跑程序。让设计图到机床的距离只剩下一次“**另存为**”。