简介这是一份面向WPF与.NET桌面开发者的DXF图形显示示例源码围绕将AutoCAD导出的DXF文件解析并绘制到Canvas控件这一目标适合需要实现CAD图纸预览、矢量图形展示或进行WPF图形编程练习的初中级开发者参考。压缩包共50个文件约143KB包含C#源码、项目与解决方案文件、资源配置、可执行程序以及两份DXF示例图目录覆盖解析器、数据模型、Canvas绘制与界面等模块便于直接编译运行并对照理解实体到WPF形状的映射过程。已有1857人学习下载说明其在WPF图形显示方向具有一定参考价值。代码中可看到DXF实体解析、图层与颜色线型处理、Canvas子元素动态添加以及鼠标交互和性能优化思路配合示例文件可较快搭建可运行的预览程序也能为后续扩展缩放、平移与选中功能提供基础。1. 从一张八万线段的图纸说起DXF 文件丢进 WPF Canvas 到底难在哪某公司的设备图纸还是 DXF 格式要求做一个 Windows 端看图工具双击能开、滚轮缩放、点线高亮最好能按图层隐藏。需求听着简单——DXF 文件读进来丢到 WPF Canvas 上画线就完了。结果第一版跑起来八万条线段的图纸点了三秒才出画面块引用全飘到画布外圆弧被画成了折线还上下颠倒。这个项目要干的事就是把 DXF 里的组码、块表、图层、颜色翻译成 WPF 能吃的图元再在一个可缩放可漫游的 Canvas 上稳定画出来。适合两类人看手上有看图、审图需求要交差的开发者以及想搞清楚 Canvas 渲染性能瓶颈到底在哪的 WPF 老手。2. 工程结构与选型解析层和渲染层必须切开动手之前先说清楚一件事这个项目最容易翻车的地方是“边读边画”。很多示例代码为了短解析到一条 LINE 就 new 一个 Line 塞进 Canvas几万条实体立刻把 WPF 的布局系统拖死。正确的结构是解析完先产出一个纯数据的图元列表渲染层只认这个列表两边的坐标系、单位、块变换都在数据层就处理干净。这样后面想换渲染方案Shape 换 DrawingVisual、换到 SkiaSharp 导出图片不用动解析代码。2.1 目录结构四层各管一件事工程按“加载 - 图元 - 渲染 - 交互”四层拆目录大致是这样DxfCanvasViewer/ ├─ App.xaml ├─ MainWindow.xaml / MainWindow.xaml.cs // 只做窗口装配和命令绑定 ├─ Core/ │ ├─ DxfDrawingLoader.cs // 文件 - DxfDrawing唯一入口 │ ├─ DxfDrawing.cs // 图元集合 包围盒 单位 │ ├─ DxfPrimitive.cs // 统一图元折线 图层 颜色 │ ├─ BlockExpander.cs // INSERT 递归展开与矩阵变换 │ └─ AciPalette.cs // ACI 索引色 - 画刷缓存 ├─ Rendering/ │ ├─ ViewportMatrix.cs // 世界坐标 - 屏幕坐标 │ ├─ ShapeRenderer.cs // Canvas Shape小图/需要交互时用 │ └─ VisualRenderer.cs // DrawingVisual StreamGeometry大图用 ├─ Interaction/ │ ├─ PanZoomController.cs // 中键拖动 滚轮锚点缩放 │ └─ SelectionService.cs // 命中测试与高亮 └─ Samples/sample.dxf这套目录的好处是每个文件职责单一ViewportMatrix是唯一知道“Y 轴要翻转”的地方AciPalette是唯一知道颜色索引怎么映射的地方。血泪经验是别把这些散在 XAML 后台代码里等到要加导出图片功能时你会发现到处都是硬编码的 1.0 和 90。2.2 为什么用现成解析库但一定要懂组码DXF 本质是纯文本一行组码一行值交替。解析库能省掉 tab 表、块表、扩展数据这些脏活但图纸出问题时实体丢了、坐标错了、中文乱码你必须能自己拿文本编辑器打开文件定位到是哪一段组码不对。所以我的习惯是正式代码用解析库同时留一个几十行的组码读取器做排查工具。// 最小化组码读取器只用来排查问题不参与生产渲染 using var reader new StreamReader(path, Encoding.UTF8, detectEncodingFromByteOrderMarks: true); string? codeLine; string section string.Empty; while ((codeLine reader.ReadLine()) ! null) { if (!int.TryParse(codeLine.Trim(), out int code)) continue; // 空行和脏行直接跳 string value reader.ReadLine() ?? string.Empty; if (code 0 value SECTION) section string.Empty; // 0 号组码 结构/实体类型 else if (code 2) section value; // 2 号组码 名字SECTION 名/块名/图层名 else if (code 8) { /* 8 号 图层名实体归属 */ } // 10/20/30 起点 XYZ11/21/31 终点40 半径或比例50 角度62 颜色索引 }code 0是分界的核心SECTION、ENDSEC、LINE、LWPOLYLINE、INSERT、EOF都出现在 0 号组码上。搞清楚这一点你就能在文本里快速数出“这张图到底有多少个 INSERT”也能验证是不是库把某个实体吞了。生产环境的加载入口长这样public static DxfDrawing Load(string path) { // 解析库不同版本的重载名略有差异按锁定的版本调整解码失败总比静默返回 null 好 var doc DxfDocument.Load(path) ?? throw new InvalidDataException($DXF 解析失败文件可能被截断: {path}); var drawing new DxfDrawing { InsUnits doc.HeaderVariables.InsUnits, // 图纸单位影响后续毫米/英寸换算 }; foreach (EntityObject entity in doc.Entities.All) BlockExpander.Expand(entity, Matrix3.Identity, 0, drawing.Primitives); drawing.RecalculateBounds(); // 空图要兜底别让包围盒宽高为 0 return drawing; }参数上只有一个地方需要留意doc.Entities.All会连块内实体一起给出来如果你自己还要展开 INSERT就会重复绘制所以要么走All并跳过 INSERT要么只遍历顶层实体自己做递归。我选后者因为块内实体需要叠加父级变换矩阵All拿到的坐标是块内局部坐标。2.3 图元模型把几十种实体压成一种DXF 实体类型几十个但真正常见的就 LINE、LWPOLYLINE、POLYLINE、ARC、CIRCLE、TEXT、MTEXT、INSERT。渲染层没兴趣知道你原来是什么只要能拿到一串屏幕坐标。所以统一图元设计成一个折线列表字段类型说明PointsPoint[]世界坐标下的折线点圆弧已离散成折线KindenumLine / Polyline / Arc / Circle / Text只用于命中测试和调试Layerstring图层名用于图层开关和 ByLayer 取色ColorIndexshort已解析过的 ACI 索引色不再保留 ByLayer 语义Thicknessdouble默认 0需要线宽时再填曲线离散精度是个纯工程问题弦高误差控制在 0.2 个图纸单位以内一般 BEZIER 用 16 段、大半径圆弧按角度每 5 度一段。离散得太细十万个点位的几何体在缩放时会明显卡顿太粗则圆看着像多边形。3. 解析链路从组码到可绘制图元解析这一层是整个项目的地基做对了后面画什么都顺做错了就是“图能出来但就是不对”。这条链路有四步定位实体、分发类型、展开块引用、解析颜色线型。每一步都有一个能让人调半天的小坑。3.1 实体分发一行 switch 决定画什么分发用 C# 的模式匹配最直观新增实体类型只要加一个 case。注意 Y 轴这里千万别翻翻转放到渲染层统一做否则块变换的矩阵会和翻转叠加两次出现“顶层实体正常、块内实体镜像”的诡异现象。private static DxfPrimitive? ToPrimitive(EntityObject entity, Matrix3 world) { switch (entity) { case Line line: return Create(line.StartPoint, line.EndPoint, line, world); case Circle circle: // 圆按 72 段离散半径乘外层缩放后再决定段数更准这里先用固定值 return CreateArc(circle.Center, circle.Radius, 0, 360, circle, world); case Arc arc: return CreateArc(arc.Center, arc.Radius, arc.StartAngle, arc.EndAngle, arc, world); case LwPolyline lw: // Bulge 是弧段凸度标记不为 0 的一段要按圆弧单独离散忽略它就是“圆角变直角”的元凶 return CreatePolyline(lw.Vertexes, lw, world); case Text text: return CreateText(text.Value, text.Position, text.Height, text.Rotation, text, world); default: return null; // 不认识的实体直接跳过但要计数打日志别静默吞掉 } }Create系列内部做的事只有两件把点乘上world矩阵把entity.Layer.Name和颜色索引抄进图元。这里有个细节——默认构造函数里IsVisible为 true 才收被冻结或关闭图层的实体entity.IsVisible false要过滤掉否则客户会说“怎么多出来一堆辅助线”。3.2 块引用展开矩阵顺序写反就是万劫不复INSERT 是这个项目里最容易出错的部分。一个块有自己的基准点BasePoint插入时有位置、缩放、旋转块里还能再套块。正确的变换顺序是先减基准点把块挪回原点再缩放再旋转最后平移到插入点。public static void Expand(EntityObject entity, Matrix3 parent, int depth, ListDxfPrimitive output) { if (depth 8) return; // 自引用块会无限递归8 层对机械图纸足够 if (entity is Insert insert insert.Block ! null) { var m Matrix3.Identity; m * Matrix3.Translation(-insert.Block.Origin.X, -insert.Block.Origin.Y, 0); // 1. 回基准点 m * Matrix3.Scaling(insert.Scale.X, insert.Scale.Y, 1); // 2. 缩放 m * Matrix3.Rotation(insert.Rotation * Math.PI / 180.0); // 3. 旋转DXF 里是角度 m * Matrix3.Translation(insert.Position.X, insert.Position.Y, 0); // 4. 落到插入点 foreach (EntityObject child in insert.Block.Entities) Expand(child, m * parent, depth 1, output); // 父变换后乘别写反 return; } DxfPrimitive? primitive ToPrimitive(entity, parent); if (primitive ! null) output.Add(primitive); }矩阵乘法顺序是行向量约定还是列向量约定不同库不一样写反的表现是块整体飞到画布外或者绕原点打转。验证方法很简单画一个基准点在 (0,0)、插入点在 (100,50) 的块如果它出现在 (100,50) 附近就对了出现在 (100,-50) 就是某个地方多翻了 Y。3.3 颜色与线型ByLayer 必须当面解析掉DXF 里的颜色是 ACI 索引1 红、2 黄、3 绿、4 青、5 蓝、6 品红、7 白/黑还有 256 表示 ByLayer、0 表示 ByBlock。渲染层不该关心这些语义所以在图元生成阶段就解析成真实索引。private static short ResolveColor(EntityObject entity) { short index entity.Color.Index; if (index 256) index entity.Layer.Color.Index; // ByLayer取图层颜色 if (index 0) index 7; // ByBlock退化成前景色 return index; }线型实线、虚线、点划线建议先统一按实线画。原因很现实DXF 的线型是按图纸单位定义图案长度的缩放后要么密到看不清、要么稀到看不出是虚线客户体验反而更差。真要做就按屏幕像素定义 dash pattern跟缩放解耦。4. Canvas 渲染坐标、缩放和性能三道关数据层干净了渲染层要解决三个问题Y 轴朝上怎么翻、缩放漫游怎么做、几万个图元怎么画才不卡。这三件事的处理方式直接决定了这个工具是“能看”还是“好用”。4.1 一次矩阵搞定 Y 轴翻转和自适应DXF 的 Y 轴朝上WPF 的 Y 轴朝下这中间的翻转不要在每个点上手动改而是构造一个从世界坐标到屏幕坐标的矩阵全项目只此一份。public static Matrix BuildFitMatrix(Rect bounds, Size viewport, double margin 24) { double sx (viewport.Width - margin * 2) / Math.Max(bounds.Width, 1e-6); double sy (viewport.Height - margin * 2) / Math.Max(bounds.Height, 1e-6); double s Math.Min(sx, sy); // 取小值保证图纸完整装进视口不拉伸变形 var m Matrix.Identity; m.Translate(-bounds.X, -bounds.Y); // 1. 包围盒左上角挪到原点 m.Scale(s, -s); // 2. 等比缩放 Y 轴翻转 m.Translate(margin, bounds.Height * s margin);// 3. 落到视口里留边距 return m; }WPF 的Matrix是行向量约定点乘矩阵所以调用顺序就是实际执行顺序先平移、再缩放、最后落到视口。任何一步调换位置画出来的都是镜像或者跑到屏幕外。这套写法还顺便解决了单位问题——不管图纸是毫米还是英寸bounds都是图纸自己算出来的缩放系数自适应。4.2 缩放漫游锚点不对用户立刻觉得“这软件很怪”滚轮缩放的关键不是缩放本身是缩放中心。以视口中心缩放用户想放大的细节会跑走以鼠标位置为锚点才符合看图软件的手感。private void OnMouseWheel(object sender, MouseWheelEventArgs e) { Point anchor e.GetPosition(this); // 鼠标在控件内的屏幕坐标 double factor e.Delta 0 ? 1.12 : 1 / 1.12; // 每次约 12%手感比 1.5 倍稳 var zoom Matrix.Identity; zoom.ScaleAt(factor, factor, anchor.X, anchor.Y); // 以锚点为中心缩放 _worldToScreen _worldToScreen * zoom; // 追加在现有变换之后 InvalidateVisual(); // 让宿主元素重绘别去动子元素 }中键拖动漫游就更简单了记录上一次鼠标位置差值累加一个Translate就行。要注意的是拖动时不要重建图元几何只更新矩阵然后重绘——重建几何是 O(n)拖一下卡一下的根源全在这里。4.3 千级用 Shape万级必须 DrawingVisual 批处理两条路线的对比如下选错了后期很难改方案适用规模优点代价Canvas Line/Path2000 图元以内每个图元是独立元素命中测试、动画、样式都简单元素数一多布局和渲染线程全崩DrawingVisual StreamGeometry十万图元一次 DrawGeometry 画一批性能高一个数量级交互要自己做命中测试批处理的核心是同色同层的线段合成一个StreamGeometry一个GeometryDrawing就是一个 draw callprivate DrawingGroup BuildGroup(IEnumerableDxfPrimitive primitives, Matrix m) { var group new DrawingGroup(); // 按「图层 颜色」分桶八万段线通常能压到几百个几何体 foreach (var bucket in primitives.GroupBy(p (p.Layer, p.ColorIndex))) { var geometry new StreamGeometry(); using (StreamGeometryContext ctx geometry.Open()) { foreach (DxfPrimitive p in bucket) { if (p.Points.Length 2) continue; ctx.BeginFigure(m.Transform(p.Points[0]), isFilled: false, isClosed: false); // isStrokedtrue 才画线isSmoothJoinfalse 保住直角拐点 ctx.PolyLineTo(p.Points.Skip(1).Select(m.Transform).ToArray(), true, false); } } geometry.Freeze(); // 冻结后跳过依赖属性开销还能跨线程复用 var pen new Pen(AciPalette.Get(bucket.Key.ColorIndex), 1.0); // 1.0 是屏幕像素 pen.Freeze(); // Pen 也要冻 group.Children.Add(new GeometryDrawing(null, pen, geometry)); } group.Freeze(); return group; }两个要点。第一点在乘完矩阵之后才进几何所以Pen的线宽是屏幕像素缩放时线始终是 1 像素——想要“线随缩放变粗”就得反过来在世界坐标画并设Thickness 1/scale但那样细线缩放后会糊成一片。第二Freeze()一定要调尤其是Pen和Geometry不冻结的话 WPF 每帧都要走一遍变更通知性能差距肉眼可见。4.4 命中测试先包围盒粗筛再精确命中DrawingVisual 方案下没有现成的 Shape 可点得自己做。做法是维护每个图元的包围盒世界坐标鼠标点击时先转成世界坐标做包围盒粗筛剩下的再用点到线段距离公式精算阈值取3 / scale世界单位也就是屏幕上 3 像素。public DxfPrimitive? HitTest(Point screenPoint, Matrix worldToScreen, double tolerancePx 4) { var inverse worldToScreen; inverse.Invert(); // 屏幕 - 世界矩阵可逆才继续 Point world inverse.Transform(screenPoint); double tol tolerancePx / Math.Abs(worldToScreen.M11); // 屏幕容差换算成世界容差 return _primitives .Where(p p.Bounds.Contains(world, tol)) // 粗筛99% 的图元在这里被排除 .OrderBy(p DistanceToPolyline(p, world)) // 精算点到折线距离 .FirstOrDefault(p DistanceToPolyline(p, world) tol); }高亮千万别去改原图元的颜色——那会触发整组几何重建。正确做法是在上面叠一个专门的“高亮层” DrawingVisual只放被选中的那几条线重绘成本是常数级。5. 避坑记录五个把图纸画歪、画慢、画丢的坑下面这五条都是真机上跑出来的每条按现象、原因、解决写遇到同款可以直接对号入座。5.1 图形上下颠倒、块内实体镜像现象顶层实体位置正常块里的实体全部上下翻过来或者整张图是镜像的。原因Y 轴翻转被做了两次——一次在解析时对点做-y一次在渲染矩阵里Scale(s, -s)。块变换矩阵里如果还带了旋转负缩放和旋转叠加会让镜像方向更不可预测。解决翻转只允许出现在BuildFitMatrix里这一处解析层永远输出标准 DXF 世界坐标。加一个单元测试构造一个从 (0,0) 到 (100,0) 的 LINE走完全流程后屏幕坐标的 X 必须递增Y 必须相等。5.2 打开大图白屏三秒拖动像幻灯片现象小图纸秒开四万条以上线段的图纸点了没反应任务管理器里内存飙到 1G 以上。原因每条线段都new Line()加到 Canvas 的 Children 里。WPF 的布局系统会对每个子元素做测量和排列四万个元素就是四万次布局加上每个元素独立的依赖属性存储直接拖死 UI 线程。解决超过 2000 图元的图纸直接切DrawingVisual StreamGeometry批处理图元不进可视化树只挂一个宿主元素。切换后同一张图从 3 秒降到 200ms 左右拖动稳定在 60 帧。判定阈值写在加载器里别让调用方去猜。5.3 块引用位置全乱、缩放后飞到屏幕外现象图纸主体正常带 INSERT 的部分要么堆在原点要么整体偏移几百个单位。原因矩阵乘法顺序错或者漏掉了Block.Origin基准点的偏移。块内实体坐标是相对基准点定义的不减基准点直接乘缩放和旋转等于绕原点转了一圈。解决严格按“减基准点 → 缩放 → 旋转 → 平移插入点”的顺序并注意库的矩阵是行向量还是列向量约定。验证办法是造一个基准点 (10,10)、插入点 (100,50)、缩放 2 倍的块块内 (10,10) 那个点最终必须落在 (100,50)。5.4 线宽糊成一坨、缩放后线条粗得看不见图现象放大到 10 倍后线条变成一片黑色图完全看不清。原因在世界坐标下用固定线宽画线缩放矩阵把线宽一起放大了等效线宽变成 10 像素。解决把点变换到屏幕坐标后再建几何Pen固定 1.0 像素线宽与缩放解耦。如果确实需要按图纸线宽显示就在Pen上做一个小范围钳制比如Math.Clamp(thickness * scale, 0.5, 3.0)。5.5 中文文字变问号或者干脆不显示现象标注里的中文全是乱码或者图元列表里有文字实体但画面上什么都没有。原因两个独立问题。一是文件编码老图纸用 GBK 存按 UTF-8 读就是乱码二是FormattedText构造需要pixelsPerDip参数传错或者用错字体文字会被裁掉。解决读流时先看文件头部的$DWGCODEPAGE按它选编码读不出来再回退 GBK。文字渲染用VisualTreeHelper.GetDpi(this).PixelsPerDip取 DPI字体用系统里确定存在的中文族名画之前先Measure()一下拿到尺寸避免被裁。6. 二次开发把只读预览改成能干活的小工具这套代码跑通之后多数人会往两个方向改一是加编辑能力二是接进现有系统。分享几个改动成本低、收益明显的点。第一个是把加载源抽象掉。现在入口是DxfDrawingLoader.Load(string path)只要把它抽成IDxfSource接口实现一个StreamDxfSource就能从网络、数据库或者内存流加载后面接服务端下发的图纸不用改渲染层一行代码public interface IDxfSource { TaskDxfDrawing LoadAsync(CancellationToken ct default); } public sealed class StreamDxfSource : IDxfSource { private readonly FuncTaskStream _open; // 延迟打开方便重试 public StreamDxfSource(FuncTaskStream open) _open open; public async TaskDxfDrawing LoadAsync(CancellationToken ct default) { await using Stream stream await _open(); // 解析是纯 CPU 活扔到线程池别在 UI 线程上等 return await Task.Run(() DxfDrawingLoader.Load(stream), ct); } }第二个是加“标注层”。不要往图元列表里塞标注数据那会把只读数据和用户数据混在一起。正确做法是再加一个DrawingVisual层用户标注、选中高亮、测量线都放这一层导出时可以选择“只导底图”或者“连标注一起导”。图层顺序是底图、标注、交互三层的矩阵共用一个_worldToScreen缩放过一次全部同步。第三个是导出图片。别去截屏直接用RenderTargetBitmap按目标 DPI 重建一次矩阵按 300 DPI 的 A4 尺寸算视口宽高能导出清晰的审图文档。这一步的前提是前面所有几何都基于矩阵而不是硬编码坐标否则导出和屏幕显示对不上。还有一个我踩过的坑改完之后一定要拿“空图纸”和“单个点的图纸”各跑一遍。包围盒宽高为 0 时BuildFitMatrix里的除法会直接崩Math.Max(bounds.Width, 1e-6)这个兜底就是被客户的一张空模板图教出来的。从那以后我每次接看图类的需求都先把包围盒计算和单位对齐这两件事写成单元测试再动手画线省下来的排查时间远超写测试的时间。希望帮到你。本文还有配套的精品资源点击获取 
长河君 · 2026/10/31 22:50:22 · 阅读 1.2k DXF 图纸在 WPF Canvas 中的高性能解析与渲染实践
简介这是一份面向WPF与.NET桌面开发者的DXF图形显示示例源码围绕将AutoCAD导出的DXF文件解析并绘制到Canvas控件这一目标适合需要实现CAD图纸预览、矢量图形展示或进行WPF图形编程练习的初中级开发者参考。压缩包共50个文件约143KB包含C#源码、项目与解决方案文件、资源配置、可执行程序以及两份DXF示例图目录覆盖解析器、数据模型、Canvas绘制与界面等模块便于直接编译运行并对照理解实体到WPF形状的映射过程。已有1857人学习下载说明其在WPF图形显示方向具有一定参考价值。代码中可看到DXF实体解析、图层与颜色线型处理、Canvas子元素动态添加以及鼠标交互和性能优化思路配合示例文件可较快搭建可运行的预览程序也能为后续扩展缩放、平移与选中功能提供基础。1. 从一张八万线段的图纸说起DXF 文件丢进 WPF Canvas 到底难在哪某公司的设备图纸还是 DXF 格式要求做一个 Windows 端看图工具双击能开、滚轮缩放、点线高亮最好能按图层隐藏。需求听着简单——DXF 文件读进来丢到 WPF Canvas 上画线就完了。结果第一版跑起来八万条线段的图纸点了三秒才出画面块引用全飘到画布外圆弧被画成了折线还上下颠倒。这个项目要干的事就是把 DXF 里的组码、块表、图层、颜色翻译成 WPF 能吃的图元再在一个可缩放可漫游的 Canvas 上稳定画出来。适合两类人看手上有看图、审图需求要交差的开发者以及想搞清楚 Canvas 渲染性能瓶颈到底在哪的 WPF 老手。2. 工程结构与选型解析层和渲染层必须切开动手之前先说清楚一件事这个项目最容易翻车的地方是“边读边画”。很多示例代码为了短解析到一条 LINE 就 new 一个 Line 塞进 Canvas几万条实体立刻把 WPF 的布局系统拖死。正确的结构是解析完先产出一个纯数据的图元列表渲染层只认这个列表两边的坐标系、单位、块变换都在数据层就处理干净。这样后面想换渲染方案Shape 换 DrawingVisual、换到 SkiaSharp 导出图片不用动解析代码。2.1 目录结构四层各管一件事工程按“加载 - 图元 - 渲染 - 交互”四层拆目录大致是这样DxfCanvasViewer/ ├─ App.xaml ├─ MainWindow.xaml / MainWindow.xaml.cs // 只做窗口装配和命令绑定 ├─ Core/ │ ├─ DxfDrawingLoader.cs // 文件 - DxfDrawing唯一入口 │ ├─ DxfDrawing.cs // 图元集合 包围盒 单位 │ ├─ DxfPrimitive.cs // 统一图元折线 图层 颜色 │ ├─ BlockExpander.cs // INSERT 递归展开与矩阵变换 │ └─ AciPalette.cs // ACI 索引色 - 画刷缓存 ├─ Rendering/ │ ├─ ViewportMatrix.cs // 世界坐标 - 屏幕坐标 │ ├─ ShapeRenderer.cs // Canvas Shape小图/需要交互时用 │ └─ VisualRenderer.cs // DrawingVisual StreamGeometry大图用 ├─ Interaction/ │ ├─ PanZoomController.cs // 中键拖动 滚轮锚点缩放 │ └─ SelectionService.cs // 命中测试与高亮 └─ Samples/sample.dxf这套目录的好处是每个文件职责单一ViewportMatrix是唯一知道“Y 轴要翻转”的地方AciPalette是唯一知道颜色索引怎么映射的地方。血泪经验是别把这些散在 XAML 后台代码里等到要加导出图片功能时你会发现到处都是硬编码的 1.0 和 90。2.2 为什么用现成解析库但一定要懂组码DXF 本质是纯文本一行组码一行值交替。解析库能省掉 tab 表、块表、扩展数据这些脏活但图纸出问题时实体丢了、坐标错了、中文乱码你必须能自己拿文本编辑器打开文件定位到是哪一段组码不对。所以我的习惯是正式代码用解析库同时留一个几十行的组码读取器做排查工具。// 最小化组码读取器只用来排查问题不参与生产渲染 using var reader new StreamReader(path, Encoding.UTF8, detectEncodingFromByteOrderMarks: true); string? codeLine; string section string.Empty; while ((codeLine reader.ReadLine()) ! null) { if (!int.TryParse(codeLine.Trim(), out int code)) continue; // 空行和脏行直接跳 string value reader.ReadLine() ?? string.Empty; if (code 0 value SECTION) section string.Empty; // 0 号组码 结构/实体类型 else if (code 2) section value; // 2 号组码 名字SECTION 名/块名/图层名 else if (code 8) { /* 8 号 图层名实体归属 */ } // 10/20/30 起点 XYZ11/21/31 终点40 半径或比例50 角度62 颜色索引 }code 0是分界的核心SECTION、ENDSEC、LINE、LWPOLYLINE、INSERT、EOF都出现在 0 号组码上。搞清楚这一点你就能在文本里快速数出“这张图到底有多少个 INSERT”也能验证是不是库把某个实体吞了。生产环境的加载入口长这样public static DxfDrawing Load(string path) { // 解析库不同版本的重载名略有差异按锁定的版本调整解码失败总比静默返回 null 好 var doc DxfDocument.Load(path) ?? throw new InvalidDataException($DXF 解析失败文件可能被截断: {path}); var drawing new DxfDrawing { InsUnits doc.HeaderVariables.InsUnits, // 图纸单位影响后续毫米/英寸换算 }; foreach (EntityObject entity in doc.Entities.All) BlockExpander.Expand(entity, Matrix3.Identity, 0, drawing.Primitives); drawing.RecalculateBounds(); // 空图要兜底别让包围盒宽高为 0 return drawing; }参数上只有一个地方需要留意doc.Entities.All会连块内实体一起给出来如果你自己还要展开 INSERT就会重复绘制所以要么走All并跳过 INSERT要么只遍历顶层实体自己做递归。我选后者因为块内实体需要叠加父级变换矩阵All拿到的坐标是块内局部坐标。2.3 图元模型把几十种实体压成一种DXF 实体类型几十个但真正常见的就 LINE、LWPOLYLINE、POLYLINE、ARC、CIRCLE、TEXT、MTEXT、INSERT。渲染层没兴趣知道你原来是什么只要能拿到一串屏幕坐标。所以统一图元设计成一个折线列表字段类型说明PointsPoint[]世界坐标下的折线点圆弧已离散成折线KindenumLine / Polyline / Arc / Circle / Text只用于命中测试和调试Layerstring图层名用于图层开关和 ByLayer 取色ColorIndexshort已解析过的 ACI 索引色不再保留 ByLayer 语义Thicknessdouble默认 0需要线宽时再填曲线离散精度是个纯工程问题弦高误差控制在 0.2 个图纸单位以内一般 BEZIER 用 16 段、大半径圆弧按角度每 5 度一段。离散得太细十万个点位的几何体在缩放时会明显卡顿太粗则圆看着像多边形。3. 解析链路从组码到可绘制图元解析这一层是整个项目的地基做对了后面画什么都顺做错了就是“图能出来但就是不对”。这条链路有四步定位实体、分发类型、展开块引用、解析颜色线型。每一步都有一个能让人调半天的小坑。3.1 实体分发一行 switch 决定画什么分发用 C# 的模式匹配最直观新增实体类型只要加一个 case。注意 Y 轴这里千万别翻翻转放到渲染层统一做否则块变换的矩阵会和翻转叠加两次出现“顶层实体正常、块内实体镜像”的诡异现象。private static DxfPrimitive? ToPrimitive(EntityObject entity, Matrix3 world) { switch (entity) { case Line line: return Create(line.StartPoint, line.EndPoint, line, world); case Circle circle: // 圆按 72 段离散半径乘外层缩放后再决定段数更准这里先用固定值 return CreateArc(circle.Center, circle.Radius, 0, 360, circle, world); case Arc arc: return CreateArc(arc.Center, arc.Radius, arc.StartAngle, arc.EndAngle, arc, world); case LwPolyline lw: // Bulge 是弧段凸度标记不为 0 的一段要按圆弧单独离散忽略它就是“圆角变直角”的元凶 return CreatePolyline(lw.Vertexes, lw, world); case Text text: return CreateText(text.Value, text.Position, text.Height, text.Rotation, text, world); default: return null; // 不认识的实体直接跳过但要计数打日志别静默吞掉 } }Create系列内部做的事只有两件把点乘上world矩阵把entity.Layer.Name和颜色索引抄进图元。这里有个细节——默认构造函数里IsVisible为 true 才收被冻结或关闭图层的实体entity.IsVisible false要过滤掉否则客户会说“怎么多出来一堆辅助线”。3.2 块引用展开矩阵顺序写反就是万劫不复INSERT 是这个项目里最容易出错的部分。一个块有自己的基准点BasePoint插入时有位置、缩放、旋转块里还能再套块。正确的变换顺序是先减基准点把块挪回原点再缩放再旋转最后平移到插入点。public static void Expand(EntityObject entity, Matrix3 parent, int depth, ListDxfPrimitive output) { if (depth 8) return; // 自引用块会无限递归8 层对机械图纸足够 if (entity is Insert insert insert.Block ! null) { var m Matrix3.Identity; m * Matrix3.Translation(-insert.Block.Origin.X, -insert.Block.Origin.Y, 0); // 1. 回基准点 m * Matrix3.Scaling(insert.Scale.X, insert.Scale.Y, 1); // 2. 缩放 m * Matrix3.Rotation(insert.Rotation * Math.PI / 180.0); // 3. 旋转DXF 里是角度 m * Matrix3.Translation(insert.Position.X, insert.Position.Y, 0); // 4. 落到插入点 foreach (EntityObject child in insert.Block.Entities) Expand(child, m * parent, depth 1, output); // 父变换后乘别写反 return; } DxfPrimitive? primitive ToPrimitive(entity, parent); if (primitive ! null) output.Add(primitive); }矩阵乘法顺序是行向量约定还是列向量约定不同库不一样写反的表现是块整体飞到画布外或者绕原点打转。验证方法很简单画一个基准点在 (0,0)、插入点在 (100,50) 的块如果它出现在 (100,50) 附近就对了出现在 (100,-50) 就是某个地方多翻了 Y。3.3 颜色与线型ByLayer 必须当面解析掉DXF 里的颜色是 ACI 索引1 红、2 黄、3 绿、4 青、5 蓝、6 品红、7 白/黑还有 256 表示 ByLayer、0 表示 ByBlock。渲染层不该关心这些语义所以在图元生成阶段就解析成真实索引。private static short ResolveColor(EntityObject entity) { short index entity.Color.Index; if (index 256) index entity.Layer.Color.Index; // ByLayer取图层颜色 if (index 0) index 7; // ByBlock退化成前景色 return index; }线型实线、虚线、点划线建议先统一按实线画。原因很现实DXF 的线型是按图纸单位定义图案长度的缩放后要么密到看不清、要么稀到看不出是虚线客户体验反而更差。真要做就按屏幕像素定义 dash pattern跟缩放解耦。4. Canvas 渲染坐标、缩放和性能三道关数据层干净了渲染层要解决三个问题Y 轴朝上怎么翻、缩放漫游怎么做、几万个图元怎么画才不卡。这三件事的处理方式直接决定了这个工具是“能看”还是“好用”。4.1 一次矩阵搞定 Y 轴翻转和自适应DXF 的 Y 轴朝上WPF 的 Y 轴朝下这中间的翻转不要在每个点上手动改而是构造一个从世界坐标到屏幕坐标的矩阵全项目只此一份。public static Matrix BuildFitMatrix(Rect bounds, Size viewport, double margin 24) { double sx (viewport.Width - margin * 2) / Math.Max(bounds.Width, 1e-6); double sy (viewport.Height - margin * 2) / Math.Max(bounds.Height, 1e-6); double s Math.Min(sx, sy); // 取小值保证图纸完整装进视口不拉伸变形 var m Matrix.Identity; m.Translate(-bounds.X, -bounds.Y); // 1. 包围盒左上角挪到原点 m.Scale(s, -s); // 2. 等比缩放 Y 轴翻转 m.Translate(margin, bounds.Height * s margin);// 3. 落到视口里留边距 return m; }WPF 的Matrix是行向量约定点乘矩阵所以调用顺序就是实际执行顺序先平移、再缩放、最后落到视口。任何一步调换位置画出来的都是镜像或者跑到屏幕外。这套写法还顺便解决了单位问题——不管图纸是毫米还是英寸bounds都是图纸自己算出来的缩放系数自适应。4.2 缩放漫游锚点不对用户立刻觉得“这软件很怪”滚轮缩放的关键不是缩放本身是缩放中心。以视口中心缩放用户想放大的细节会跑走以鼠标位置为锚点才符合看图软件的手感。private void OnMouseWheel(object sender, MouseWheelEventArgs e) { Point anchor e.GetPosition(this); // 鼠标在控件内的屏幕坐标 double factor e.Delta 0 ? 1.12 : 1 / 1.12; // 每次约 12%手感比 1.5 倍稳 var zoom Matrix.Identity; zoom.ScaleAt(factor, factor, anchor.X, anchor.Y); // 以锚点为中心缩放 _worldToScreen _worldToScreen * zoom; // 追加在现有变换之后 InvalidateVisual(); // 让宿主元素重绘别去动子元素 }中键拖动漫游就更简单了记录上一次鼠标位置差值累加一个Translate就行。要注意的是拖动时不要重建图元几何只更新矩阵然后重绘——重建几何是 O(n)拖一下卡一下的根源全在这里。4.3 千级用 Shape万级必须 DrawingVisual 批处理两条路线的对比如下选错了后期很难改方案适用规模优点代价Canvas Line/Path2000 图元以内每个图元是独立元素命中测试、动画、样式都简单元素数一多布局和渲染线程全崩DrawingVisual StreamGeometry十万图元一次 DrawGeometry 画一批性能高一个数量级交互要自己做命中测试批处理的核心是同色同层的线段合成一个StreamGeometry一个GeometryDrawing就是一个 draw callprivate DrawingGroup BuildGroup(IEnumerableDxfPrimitive primitives, Matrix m) { var group new DrawingGroup(); // 按「图层 颜色」分桶八万段线通常能压到几百个几何体 foreach (var bucket in primitives.GroupBy(p (p.Layer, p.ColorIndex))) { var geometry new StreamGeometry(); using (StreamGeometryContext ctx geometry.Open()) { foreach (DxfPrimitive p in bucket) { if (p.Points.Length 2) continue; ctx.BeginFigure(m.Transform(p.Points[0]), isFilled: false, isClosed: false); // isStrokedtrue 才画线isSmoothJoinfalse 保住直角拐点 ctx.PolyLineTo(p.Points.Skip(1).Select(m.Transform).ToArray(), true, false); } } geometry.Freeze(); // 冻结后跳过依赖属性开销还能跨线程复用 var pen new Pen(AciPalette.Get(bucket.Key.ColorIndex), 1.0); // 1.0 是屏幕像素 pen.Freeze(); // Pen 也要冻 group.Children.Add(new GeometryDrawing(null, pen, geometry)); } group.Freeze(); return group; }两个要点。第一点在乘完矩阵之后才进几何所以Pen的线宽是屏幕像素缩放时线始终是 1 像素——想要“线随缩放变粗”就得反过来在世界坐标画并设Thickness 1/scale但那样细线缩放后会糊成一片。第二Freeze()一定要调尤其是Pen和Geometry不冻结的话 WPF 每帧都要走一遍变更通知性能差距肉眼可见。4.4 命中测试先包围盒粗筛再精确命中DrawingVisual 方案下没有现成的 Shape 可点得自己做。做法是维护每个图元的包围盒世界坐标鼠标点击时先转成世界坐标做包围盒粗筛剩下的再用点到线段距离公式精算阈值取3 / scale世界单位也就是屏幕上 3 像素。public DxfPrimitive? HitTest(Point screenPoint, Matrix worldToScreen, double tolerancePx 4) { var inverse worldToScreen; inverse.Invert(); // 屏幕 - 世界矩阵可逆才继续 Point world inverse.Transform(screenPoint); double tol tolerancePx / Math.Abs(worldToScreen.M11); // 屏幕容差换算成世界容差 return _primitives .Where(p p.Bounds.Contains(world, tol)) // 粗筛99% 的图元在这里被排除 .OrderBy(p DistanceToPolyline(p, world)) // 精算点到折线距离 .FirstOrDefault(p DistanceToPolyline(p, world) tol); }高亮千万别去改原图元的颜色——那会触发整组几何重建。正确做法是在上面叠一个专门的“高亮层” DrawingVisual只放被选中的那几条线重绘成本是常数级。5. 避坑记录五个把图纸画歪、画慢、画丢的坑下面这五条都是真机上跑出来的每条按现象、原因、解决写遇到同款可以直接对号入座。5.1 图形上下颠倒、块内实体镜像现象顶层实体位置正常块里的实体全部上下翻过来或者整张图是镜像的。原因Y 轴翻转被做了两次——一次在解析时对点做-y一次在渲染矩阵里Scale(s, -s)。块变换矩阵里如果还带了旋转负缩放和旋转叠加会让镜像方向更不可预测。解决翻转只允许出现在BuildFitMatrix里这一处解析层永远输出标准 DXF 世界坐标。加一个单元测试构造一个从 (0,0) 到 (100,0) 的 LINE走完全流程后屏幕坐标的 X 必须递增Y 必须相等。5.2 打开大图白屏三秒拖动像幻灯片现象小图纸秒开四万条以上线段的图纸点了没反应任务管理器里内存飙到 1G 以上。原因每条线段都new Line()加到 Canvas 的 Children 里。WPF 的布局系统会对每个子元素做测量和排列四万个元素就是四万次布局加上每个元素独立的依赖属性存储直接拖死 UI 线程。解决超过 2000 图元的图纸直接切DrawingVisual StreamGeometry批处理图元不进可视化树只挂一个宿主元素。切换后同一张图从 3 秒降到 200ms 左右拖动稳定在 60 帧。判定阈值写在加载器里别让调用方去猜。5.3 块引用位置全乱、缩放后飞到屏幕外现象图纸主体正常带 INSERT 的部分要么堆在原点要么整体偏移几百个单位。原因矩阵乘法顺序错或者漏掉了Block.Origin基准点的偏移。块内实体坐标是相对基准点定义的不减基准点直接乘缩放和旋转等于绕原点转了一圈。解决严格按“减基准点 → 缩放 → 旋转 → 平移插入点”的顺序并注意库的矩阵是行向量还是列向量约定。验证办法是造一个基准点 (10,10)、插入点 (100,50)、缩放 2 倍的块块内 (10,10) 那个点最终必须落在 (100,50)。5.4 线宽糊成一坨、缩放后线条粗得看不见图现象放大到 10 倍后线条变成一片黑色图完全看不清。原因在世界坐标下用固定线宽画线缩放矩阵把线宽一起放大了等效线宽变成 10 像素。解决把点变换到屏幕坐标后再建几何Pen固定 1.0 像素线宽与缩放解耦。如果确实需要按图纸线宽显示就在Pen上做一个小范围钳制比如Math.Clamp(thickness * scale, 0.5, 3.0)。5.5 中文文字变问号或者干脆不显示现象标注里的中文全是乱码或者图元列表里有文字实体但画面上什么都没有。原因两个独立问题。一是文件编码老图纸用 GBK 存按 UTF-8 读就是乱码二是FormattedText构造需要pixelsPerDip参数传错或者用错字体文字会被裁掉。解决读流时先看文件头部的$DWGCODEPAGE按它选编码读不出来再回退 GBK。文字渲染用VisualTreeHelper.GetDpi(this).PixelsPerDip取 DPI字体用系统里确定存在的中文族名画之前先Measure()一下拿到尺寸避免被裁。6. 二次开发把只读预览改成能干活的小工具这套代码跑通之后多数人会往两个方向改一是加编辑能力二是接进现有系统。分享几个改动成本低、收益明显的点。第一个是把加载源抽象掉。现在入口是DxfDrawingLoader.Load(string path)只要把它抽成IDxfSource接口实现一个StreamDxfSource就能从网络、数据库或者内存流加载后面接服务端下发的图纸不用改渲染层一行代码public interface IDxfSource { TaskDxfDrawing LoadAsync(CancellationToken ct default); } public sealed class StreamDxfSource : IDxfSource { private readonly FuncTaskStream _open; // 延迟打开方便重试 public StreamDxfSource(FuncTaskStream open) _open open; public async TaskDxfDrawing LoadAsync(CancellationToken ct default) { await using Stream stream await _open(); // 解析是纯 CPU 活扔到线程池别在 UI 线程上等 return await Task.Run(() DxfDrawingLoader.Load(stream), ct); } }第二个是加“标注层”。不要往图元列表里塞标注数据那会把只读数据和用户数据混在一起。正确做法是再加一个DrawingVisual层用户标注、选中高亮、测量线都放这一层导出时可以选择“只导底图”或者“连标注一起导”。图层顺序是底图、标注、交互三层的矩阵共用一个_worldToScreen缩放过一次全部同步。第三个是导出图片。别去截屏直接用RenderTargetBitmap按目标 DPI 重建一次矩阵按 300 DPI 的 A4 尺寸算视口宽高能导出清晰的审图文档。这一步的前提是前面所有几何都基于矩阵而不是硬编码坐标否则导出和屏幕显示对不上。还有一个我踩过的坑改完之后一定要拿“空图纸”和“单个点的图纸”各跑一遍。包围盒宽高为 0 时BuildFitMatrix里的除法会直接崩Math.Max(bounds.Width, 1e-6)这个兜底就是被客户的一张空模板图教出来的。从那以后我每次接看图类的需求都先把包围盒计算和单位对齐这两件事写成单元测试再动手画线省下来的排查时间远超写测试的时间。希望帮到你。本文还有配套的精品资源点击获取