简介这套源码基于C#编写结合OnnxRuntime与OpenCvSharp实现素描画生成能将普通照片转换为动漫、轮廓或素描风格。面向对图像风格化处理、WinForm桌面应用开发感兴趣的中级开发者也适合作为毕业设计或工具类项目的参考。压缩包内共99个文件主要包括9个C#窗体代码文件、解决方案与工程配置文件、11个动态链接库、3个Onnx模型文件以及用于测试的JPG/PNG图片和可直接运行的程序整体大小约66.45兆。另有缓存、索引和资源配置等辅助文件便于完整还原项目环境。目录区分了界面逻辑、模型资源和运行库结构清晰可用Visual Studio打开解决方案后直接查看编译。目前已有186人学习下载资源完整度高从界面设计到推理调用均有代码覆盖。借助源码与现成模型可以快速搭建本地素描化工具理解图像预处理、模型加载与结果输出等关键环节还可替换不同风格模型做进一步扩展。1. 素描生成不是滤镜脚本这套C# Informative-Drawings源码把照片变成手绘线条稿生产里经常遇到这种需求产品图要出黑白稿、工业零件要生成示意图、上位机软件要把照片转成轮廓线做视觉标注。以前多数人直接调Canny出来的结果是稀疏的白色细线不是素描画。素描画的观感关键在“线条有方向、有断点、有浓淡层次”而Informative-Drawings这套C#源码做的正是从普通位图到素描线条稿的生成转换不依赖第三方商用库核心用GDI就能编译运行。它解决的问题很具体什么像素该画、沿什么方向画、画多长才像人手画的。适合两类人一类是写图像预处理管线的工程师另一类是想在WinForms或WPF里嵌入素描效果做展示的客户端开发。下面把原理、参数和坑逐个拆开。2. 原理管线拆解梯度场、方向量化与笔画聚合的三层结构要把照片变成素描不能跳过“边缘响应不等于笔画”这件事。Canny输出的是单像素宽的点集连起来像电路图手绘素描里的线条是成段的、沿轮廓方向延伸、长短不一的笔画。所以这套源码的管线分三层第一层做灰度化和高斯降噪把亮度信息从彩色通道里抽出来第二层用Sobel算子计算梯度幅值和方向并做边缘响应的筛选第三层把符合条件的边缘像素按方向聚合成有限长度的笔画再逐个渲染。下面按数据流顺序把每层的关键步骤和对应代码过一遍。2.1 灰度化与高斯模糊为什么必须先压噪再算梯度灰度化是整条管线的前提。边缘检测只关心亮度变化而彩色图里同一条轮廓在R、G、B三个通道上的梯度方向未必一致直接对彩色图算梯度会因为通道间相互干扰而漏掉轮廓。更实际的原因是灰度图的数据量只有24位彩图的三分之一后面的卷积和笔画聚合都要遍历每个像素灰度化能直接省下三分之二的遍历量。源码里灰度化用的就是标准的亮度加权公式public static byte[,] ToGray(Bitmap src) { int w src.Width, h src.Height; byte[,] gray new byte[h, w]; Rectangle rect new Rectangle(0, 0, w, h); BitmapData bd src.LockBits(rect, ImageLockMode.ReadOnly, PixelFormat.Format24bppRgb); unsafe { byte* p (byte*)bd.Scan0; for (int y 0; y h; y) { byte* row p y * bd.Stride; for (int x 0; x w; x) { byte b row[x * 3]; // 24bpp 内存顺序是 BGR byte g row[x * 3 1]; byte r row[x * 3 2]; gray[y, x] (byte)((r * 299 g * 587 b * 114) / 1000); } } } src.UnlockBits(bd); return gray; }这段代码有两个关键点。一是用LockBits加unsafe指针对像素内存直接操作比GetPixel逐点读快一两个量级在4000×3000的图上GetPixel要读1200万次每次都有封装开销而指针方式一次内存遍历就完成。二是亮度公式用整数加权逼近0.299R0.587G0.114B缩放成299、587、114三个系数避开浮点运算后面接大量卷积遍历时性能更稳。注意这里假定输入是Format24bppRgb如果传入32位带Alpha的图要么先ConvertFormat转换格式要么把这段改成Format32bppArgb并按4字节步长读取否则像素错位会让整幅图的线条全部错乱。提示编译时要允许不安全代码项目文件里把 AllowUnsafeBlocks 设为 true否则 LockBits 指针写法过不了编译。灰度图算完不要急着出边缘。噪声是素描生成的头号敌人照片暗部区域的传感器噪声在梯度图里会被放大成密密麻麻的短线段最后全变成画面上的细碎噪点。常见做法是先用一个3×3高斯核做卷积private static readonly float[,] GaussKernel new float[,] { { 1f / 16, 2f / 16, 1f / 16 }, { 2f / 16, 4f / 16, 2f / 16 }, { 1f / 16, 2f / 16, 1f / 16 } }; public static byte[,] Blur(byte[,] src, int w, int h) { byte[,] dst new byte[h, w]; for (int y 1; y h - 1; y) { for (int x 1; x w - 1; x) { float sum 0; for (int ky -1; ky 1; ky) for (int kx -1; kx 1; kx) sum src[y ky, x kx] * GaussKernel[ky 1, kx 1]; dst[y, x] (byte)sum; } } return dst; }这个核的总权重恰好为1滤波结果不会整体变亮或变暗。3×3核对应的等效Sigma大约在0.8适合城市街景、零件照片这类细节适中的输入。如果源图是夜空、白墙等大范围平滑区域3×3核压不掉低频噪声建议改成5×5核Sigma提高到1.2左右。代价是卷积次数从9次变25次但这一层在整条管线里耗时占比不高优先保质量而不是省这点时间。2.2 Sobel梯度计算方向信息决定笔画走向灰度图准备好后下一步计算每个像素的梯度幅值和梯度方向。Sobel算子是这一步的首选两个3×3卷积核分别估计X和Y方向的差分计算量小对噪声的抑制作用比直接差分好输出的梯度方向对后续笔画方向量化也足够准确。static readonly int[,] KernelX new int[,] { { -1, 0, 1 }, { -2, 0, 2 }, { -1, 0, 1 } }; static readonly int[,] KernelY new int[,] { { -1, -2, -1 }, { 0, 0, 0 }, { 1, 2, 1 } }; public static void ComputeGradient(byte[,] gray, int w, int h, out float[,] mag, out float[,] dir) { mag new float[h, w]; dir new float[h, w]; for (int y 1; y h - 1; y) { for (int x 1; x w - 1; x) { float gx 0, gy 0; for (int ky -1; ky 1; ky) { for (int kx -1; kx 1; kx) { byte v gray[y ky, x kx]; gx KernelX[ky 1, kx 1] * v; gy KernelY[ky 1, kx 1] * v; } } mag[y, x] (float)Math.Sqrt(gx * gx gy * gy); dir[y, x] (float)Math.Atan2(gy, gx); } } }这里有个非常容易踩的坐标映射问题。KernelX是左负右正所以gx指向亮度从左到右递增的方向而屏幕坐标系x轴向右、y轴向下Atan2(gy, gx)返回的是一个屏幕坐标系里的向量角度。这影响不大因为后续只关心方向的取向而不关心正负线条方向用垂直向量-gy, gx正负只决定线段从种子点向哪一头延伸不影响画出来的线是否在同一条直线上。真正要注意的是mag的取值范围不固定它取决于图像对比度不是天然落在0-255或0-1区间。如果不做归一化同一阈值在不同图像上得到的线条密度会差出去一倍。我一般会在ComputeGradient返回后多跑一次O(n)的最大值扫描把mag归一化到0-1区间再往下传public static void NormalizeMag(float[,] mag, int w, int h) { float max 0; for (int i 0; i mag.Length; i) if (mag[i] max) max mag[i]; if (max 1e-6f) return; // 全图无边缘直接跳过 for (int i 0; i mag.Length; i) mag[i] / max; }这一步直接决定了后面EdgeThreshold参数能不能做到跨图语义一致。不做归一化时参数调好了这张图换一张对比度低的图就会全部失效是“换图就翻车”的主要来源之一。2.3 笔画聚合把边缘像素连成有方向的有限长线段这是素描生成和Canny拉开差距的一层。Canny做完就是一个二值图像素之间没有“谁和谁是一条线”的语义而素描要有笔触需要把相邻且在方向上连续的边缘像素聚合成一段段笔画。源码里的做法是先按梯度方向把像素分到角度桶默认8个方向每桶45度然后从每个未访问而且幅值过阈值的像素出发沿桶方向向两端延伸延伸过程中允许幅值降到阈值的八成但方向偏离超过1.5个桶距就断线延伸长度上限由StrokeMaxLength控制。public class Stroke { public PointF Start; public PointF End; public float Width; public byte Intensity; } public static ListStroke TraceStrokes(byte[,] gray, float[,] mag, float[,] dir, int w, int h, float thresh, int maxLen, int numDirs) { bool[,] used new bool[h, w]; int bucketAngle 360 / numDirs; var strokes new ListStroke(); for (int y 1; y h - 1; y) { for (int x 1; x w - 1; x) { if (used[y, x] || mag[y, x] thresh) continue; used[y, x] true; float angleDeg dir[y, x] * 180f / (float)Math.PI 90f; // 转到线条延伸方向 angleDeg (angleDeg 360f) % 360f; int bucket (int)(angleDeg / bucketAngle) * bucketAngle; float rad bucket * (float)Math.PI / 180f; float nx (float)Math.Cos(rad), ny (float)Math.Sin(rad); PointF s new PointF(x, y), e new PointF(x, y); // sign1 正向延伸sign-1 反向延伸逻辑完全对称 for (int sign 1; sign -1; sign - 2) { for (int step 1; step maxLen; step) { int cx (int)Math.Round(x sign * nx * step); int cy (int)Math.Round(y sign * ny * step); if (cx 0 || cy 0 || cx w - 1 || cy h - 1) break; if (used[cy, cx]) break; if (mag[cy, cx] thresh * 0.8f) break; float d dir[cy, cx] * 180f / (float)Math.PI 90f; d (d 360f) % 360f; float diff Math.Abs(d - bucket); diff Math.Min(diff, 360f - diff); if (diff bucketAngle * 1.5f) break; used[cy, cx] true; if (sign 0) e new PointF(cx, cy); else s new PointF(cx, cy); } } strokes.Add(new Stroke { Start s, End e, Width 1f, Intensity 255 }); } } return strokes; }这段逻辑里阈值的作用有两个层次。thresh是种子阈值决定哪些像素有资格作为笔画起点延伸时的thresh * 0.8f是延续阈值允许笔画穿过一些稍微弱一点的边缘像素。这种做法比单阈值更符合手绘习惯起笔要干净但笔画一旦起头就允许顺势带过轻微起伏。方向约束diff bucketAngle * 1.5f则是防止一条笔画在拐角处硬转弯手绘里的拐角通常表现为两段笔画相交不是一条线平滑拐过去。如果这里不加约束所有边缘会被连成一条又长又扭曲的蛇形线完全失去笔触感。到这里前三层管线已经完整灰度化、高斯模糊、Sobel梯度、笔画聚合。剩下的是把strokes列表画到白底Bitmap上这一步属于渲染层用Graphics.DrawLine逐条画就行性能开销远小于前面的像素遍历。3. 把代码跑起来SketchOptions 参数结构与四组效果映射原理层讲清楚之后落地最关键的是调参。这套源码把可控参数集中在一个SketchOptions类里调用端不需要碰灰度化和Sobel的细节改四个核心参数就能在“细密铅笔稿”和“干净技术线稿”之间切换。这一章先给最小可跑工程再给参数表和风格组合。3.1 最小可跑工程入口方法与调用顺序把所有前置函数串起来就是一个干净的生成入口。调用方只需要传输入路径、输出路径和参数对象public class SketchOptions { public float EdgeThreshold { get; set; } 0.35f; // 种子阈值相对归一化后的mag public int StrokeMaxLength { get; set; } 12; // 笔画最大延伸像素数 public int Directions { get; set; } 8; // 方向桶数量4或8 public float StrokeWidth { get; set; } 1.2f; // 渲染线宽单位像素 } public static class SketchGenerator { public static void Generate(string inputPath, string outputPath, SketchOptions opt) { using (var src new Bitmap(inputPath)) { byte[,] gray ToGray(src); gray Blur(gray, src.Width, src.Height); ComputeGradient(gray, src.Width, src.Height, out var mag, out var dir); NormalizeMag(mag, src.Width, src.Height); var strokes TraceStrokes(gray, mag, dir, src.Width, src.Height, opt.EdgeThreshold, opt.StrokeMaxLength, opt.Directions); using (var dst new Bitmap(src.Width, src.Height, PixelFormat.Format24bppRgb)) using (var g Graphics.FromImage(dst)) { g.Clear(Color.White); using (var pen new Pen(Color.Black, opt.StrokeWidth)) { foreach (var st in strokes) { g.DrawLine(pen, st.Start, st.End); } } dst.Save(outputPath, ImageFormat.Png); } } } }调用方式就是一个方法调用适合WinForms按钮事件、WPF后台任务或者命令行批量脚本。要注意几件事Bitmap构造函数不校验文件路径是否有效输入路径非法时会在ToGray的LockBits阶段抛异常所以实际项目里入口处要先判断File.Exists。还有TraceStrokes返回的笔画数量在大图上可能达到几十万条Graphics.DrawLine逐条画时需要把Pen缓存起来不要在循环里new Pen否则GDI对象句柄会暴涨这个问题在下一章避坑里详细展开。3.2 四组核心参数分别控制什么参数默认值推荐范围控制内容调大以后的视觉变化EdgeThreshold0.350.15-0.60哪些像素能成为笔画起点线条变少、变干净但轮廓可能缺块StrokeMaxLength124-32单条笔画最大延伸长度线条更连贯但过长会失去手绘断笔感Directions84或8方向桶数量8向更细腻4向容易出现斜线台阶StrokeWidth1.20.5-3.0渲染线宽线越粗越接近粗炭笔细节越容易被吞这里重点讲EdgeThreshold和StrokeMaxLength的相互作用。EdgeThreshold相当于“起笔标准”设高了只有强边缘能起笔画面干净但轻微褶皱、布料纹理全丢掉设低了弱边缘全部参与线条密度暴增。但无论起笔阈值多低StrokeMaxLength都决定了每条笔画能走多远。我常用的经验是EdgeThreshold低于0.2时StrokeMaxLength要同步降到8以下否则弱边缘被连成很长的连续线画面会出现大量超出预期的长弧线看起来像面条。反过来EdgeThreshold高于0.5时StrokeMaxLength可以放到20以上因为能起笔的像素本来就不多长一点反而让轮廓完整。Directions参数容易被忽略但它是个隐形风格开关。默认8方向已经能覆盖多数场景但机械零件图边缘大多是水平和垂直长直线4方向反而更稳能避免斜向45度笔画的抖动人像或风景则必须用8方向4方向会在脸颊、树干这些曲率大的区域留下明显的多边形折线。3.3 常见风格的推荐参数组合风格EdgeThresholdStrokeMaxLengthDirectionsStrokeWidth输出观感细密铅笔稿0.20880.8线条密集层次丰富适合人像干净技术线稿0.502441.5长直线为主适合零件、建筑立面快速草图0.301681.2中等密度折中方案粗炭笔效果0.252082.5线条粗短适合强调光影的主题拿到参数不要直接套到所有图。同一个风格原图分辨率对StrokeMaxLength的影响非常大在4000×3000的大图上12像素的笔画在800×600的小图上相当于一条很长的线。我实际处理时会把StrokeMaxLength按图像最短边做一次换算公式是min(w, h) / 300例如1200×800的图最短边800除以300取整约3默认的12就要缩到3附近否则整张图全是贯穿式长线。这条经验在几种分辨率混批的场景下特别重要。4. 避坑指南素描生成最常见的五个参数与性能翻车任何图像处理管线落地时真正消耗时间的往往不是算法本身而是排查边界情况。这套源码在Windows环境和GDI下有五个高频坑我全部踩过一遍下面按现象、原因、解决写清楚。4.1 现象4000×3000图片处理耗时超过20秒UI线程整个卡死原因是ToGray、Blur、TraceStrokes三层都是同步的像素级遍历加上DrawLine几十万次调用全部在主线程执行时UI完全冻结。解决分两方面第一耗时操作必须搬进后台线程WinForms里用Task.RunWPF里用await Task.RunBitmap的读写放在任务内闭环第二性能本身也要优化重点是DrawLine这一层。笔画数量在20万条时逐条DrawLine的耗时占比接近总耗时40%改成按线宽分组、用Graphics.DrawLines批量绘制耗时能降到逐条调用的三分之一。// 按线宽分组后批量绘制减少 GDI 状态切换 var groups strokes.GroupBy(s s.Width); foreach (var grp in groups) { using (var pen new Pen(Color.Black, grp.Key)) { var pts grp.SelectMany(s new[] { s.Start, s.End }).ToArray(); g.DrawLines(pen, pts); // 一次调用画完一组 } }4.2 现象输出线条断成碎点看不出完整轮廓这是EdgeThreshold设置过高加上延伸阈值系数的问题。阈值定死在高位种子点太少每条线都起不了头。另一个隐藏原因是TraceStrokes里延续阈值用thresh * 0.8f这个固定系数限制了笔画穿过弱边缘的能力。解决是先统计mag分布把EdgeThreshold设到mag直方图80分位附近而不是凭感觉给0.35或0.5同时把延续阈值系数从0.8放宽到0.6让起笔后的笔画有更大机会跨过中间弱响应区。注意放宽后线条密度会增加配合StrokeMaxLength适当加大轮廓就能恢复完整。4.3 现象线条方向出现明显的45度或90度台阶感Directions设为4时笔画只能沿0、90、180、270四个方向走斜向轮廓会变成阶梯状折线。解决是换8方向甚至16方向。但Directions增大后还有第二个问题方向桶变细笔画更容易因为方向抖动而提前断线。所以从4改到8时最好同时把方向容差从1.5个桶距放宽到2个桶距这是连续调整不是单点开关。4.4 现象同一个参数在不同图片上结果差异巨大原因几乎都在归一化。如果ComputeGradient之后没有做NormalizeMag不同图的对比度差距直接迁移到阈值上。解决就是强制归一化并用相对值而不是绝对值调参。我习惯在SketchGenerator里留一个Debug输出每张图处理时把mag最大值、归一化后的均值、低于阈值的像素占比打到日志换图跑的时候对比这三个数能很快定位是参数问题还是图像本身问题。4.5 现象内存占用暴涨序列图批量处理时OOMBitmap没有及时释放加上Pen句柄泄漏是常见元凶。using能管住Bitmap但Pen如果在foreach里逐条new句柄会堆积到系统层GDI对句柄数的限制最终让绘制静默失败。解决就是前面说的分组批量画法Pen按组创建并用using释放LockBits和UnlockBits必须在同一个方法作用域里紧凑成对中间任何return或异常都要保证UnlockBits执行最稳妥的是把LockBits后的操作包在try/finally里或者干脆封装到方法内部不让外部拿到未解锁的Bitmap。5. 进阶技巧纸张纹理叠加与覆盖率回归验证最后讲两个在实际项目中立刻能用上的小技巧一个是让输出更像“纸上的铅笔稿”一个是给管线增加客观验证手段。5.1 纸张纹理叠加纯白底加黑线观感更像CAD打印稿不像素描。要接近真实素描纸质感常见做法是把一张浅灰噪点纹理图和线条稿做乘法叠加公式是dst base * texture / 255。C#里两次遍历就能完成// 纹理图为灰度图与线条稿逐像素相乘模拟铅笔在纸上的附着 for (int y 0; y h; y) { for (int x 0; x w; x) { int line linePixels[y, x]; int tex texPixels[y, x]; linePixels[y, x] (byte)(line * tex / 255); } }纹理图建议用低频噪声生成别直接用均匀随机噪声否则叠加后颗粒感会非常重。低频噪声的构造方法是先生成一张小尺寸随机图再双三次插值放大到目标尺寸。这样得到的纹理有自然的团状明暗更接近纸张纤维分布。5.2 覆盖率回归验证素描调参很容易陷入“肉眼看着差不多就行”但生成结果可以用一个客观指标衡量边缘覆盖率。做法是先生成一张参考二值边缘图比如高阈值的Canny结果再统计素描笔画像素中落在参考边缘3×3邻域内的比例// 覆盖率 落在参考边缘 3x3 邻域内的笔画像素数 / 笔画像素总数 float coverage hitCount / (float)totalStrokePixels;覆盖率太高说明线条只是贴边描线太低说明线条已经偏离真实边缘是风格化过头了。我一般把0.6到0.85这个区间作为有效范围低于0.6就回头检查方向量化和StrokeMaxLength。从那以后我每次改参数都会顺手跑一遍覆盖率统计和一张中间图强制自己先看数据再动参数而不是凭感觉来回试。特别是批量处理几十张图时这个习惯能省掉大量复查时间希望帮到你。本文还有配套的精品资源点击获取
简介这套源码基于C#编写结合OnnxRuntime与OpenCvSharp实现素描画生成能将普通照片转换为动漫、轮廓或素描风格。面向对图像风格化处理、WinForm桌面应用开发感兴趣的中级开发者也适合作为毕业设计或工具类项目的参考。压缩包内共99个文件主要包括9个C#窗体代码文件、解决方案与工程配置文件、11个动态链接库、3个Onnx模型文件以及用于测试的JPG/PNG图片和可直接运行的程序整体大小约66.45兆。另有缓存、索引和资源配置等辅助文件便于完整还原项目环境。目录区分了界面逻辑、模型资源和运行库结构清晰可用Visual Studio打开解决方案后直接查看编译。目前已有186人学习下载资源完整度高从界面设计到推理调用均有代码覆盖。借助源码与现成模型可以快速搭建本地素描化工具理解图像预处理、模型加载与结果输出等关键环节还可替换不同风格模型做进一步扩展。1. 素描生成不是滤镜脚本这套C# Informative-Drawings源码把照片变成手绘线条稿生产里经常遇到这种需求产品图要出黑白稿、工业零件要生成示意图、上位机软件要把照片转成轮廓线做视觉标注。以前多数人直接调Canny出来的结果是稀疏的白色细线不是素描画。素描画的观感关键在“线条有方向、有断点、有浓淡层次”而Informative-Drawings这套C#源码做的正是从普通位图到素描线条稿的生成转换不依赖第三方商用库核心用GDI就能编译运行。它解决的问题很具体什么像素该画、沿什么方向画、画多长才像人手画的。适合两类人一类是写图像预处理管线的工程师另一类是想在WinForms或WPF里嵌入素描效果做展示的客户端开发。下面把原理、参数和坑逐个拆开。2. 原理管线拆解梯度场、方向量化与笔画聚合的三层结构要把照片变成素描不能跳过“边缘响应不等于笔画”这件事。Canny输出的是单像素宽的点集连起来像电路图手绘素描里的线条是成段的、沿轮廓方向延伸、长短不一的笔画。所以这套源码的管线分三层第一层做灰度化和高斯降噪把亮度信息从彩色通道里抽出来第二层用Sobel算子计算梯度幅值和方向并做边缘响应的筛选第三层把符合条件的边缘像素按方向聚合成有限长度的笔画再逐个渲染。下面按数据流顺序把每层的关键步骤和对应代码过一遍。2.1 灰度化与高斯模糊为什么必须先压噪再算梯度灰度化是整条管线的前提。边缘检测只关心亮度变化而彩色图里同一条轮廓在R、G、B三个通道上的梯度方向未必一致直接对彩色图算梯度会因为通道间相互干扰而漏掉轮廓。更实际的原因是灰度图的数据量只有24位彩图的三分之一后面的卷积和笔画聚合都要遍历每个像素灰度化能直接省下三分之二的遍历量。源码里灰度化用的就是标准的亮度加权公式public static byte[,] ToGray(Bitmap src) { int w src.Width, h src.Height; byte[,] gray new byte[h, w]; Rectangle rect new Rectangle(0, 0, w, h); BitmapData bd src.LockBits(rect, ImageLockMode.ReadOnly, PixelFormat.Format24bppRgb); unsafe { byte* p (byte*)bd.Scan0; for (int y 0; y h; y) { byte* row p y * bd.Stride; for (int x 0; x w; x) { byte b row[x * 3]; // 24bpp 内存顺序是 BGR byte g row[x * 3 1]; byte r row[x * 3 2]; gray[y, x] (byte)((r * 299 g * 587 b * 114) / 1000); } } } src.UnlockBits(bd); return gray; }这段代码有两个关键点。一是用LockBits加unsafe指针对像素内存直接操作比GetPixel逐点读快一两个量级在4000×3000的图上GetPixel要读1200万次每次都有封装开销而指针方式一次内存遍历就完成。二是亮度公式用整数加权逼近0.299R0.587G0.114B缩放成299、587、114三个系数避开浮点运算后面接大量卷积遍历时性能更稳。注意这里假定输入是Format24bppRgb如果传入32位带Alpha的图要么先ConvertFormat转换格式要么把这段改成Format32bppArgb并按4字节步长读取否则像素错位会让整幅图的线条全部错乱。提示编译时要允许不安全代码项目文件里把 AllowUnsafeBlocks 设为 true否则 LockBits 指针写法过不了编译。灰度图算完不要急着出边缘。噪声是素描生成的头号敌人照片暗部区域的传感器噪声在梯度图里会被放大成密密麻麻的短线段最后全变成画面上的细碎噪点。常见做法是先用一个3×3高斯核做卷积private static readonly float[,] GaussKernel new float[,] { { 1f / 16, 2f / 16, 1f / 16 }, { 2f / 16, 4f / 16, 2f / 16 }, { 1f / 16, 2f / 16, 1f / 16 } }; public static byte[,] Blur(byte[,] src, int w, int h) { byte[,] dst new byte[h, w]; for (int y 1; y h - 1; y) { for (int x 1; x w - 1; x) { float sum 0; for (int ky -1; ky 1; ky) for (int kx -1; kx 1; kx) sum src[y ky, x kx] * GaussKernel[ky 1, kx 1]; dst[y, x] (byte)sum; } } return dst; }这个核的总权重恰好为1滤波结果不会整体变亮或变暗。3×3核对应的等效Sigma大约在0.8适合城市街景、零件照片这类细节适中的输入。如果源图是夜空、白墙等大范围平滑区域3×3核压不掉低频噪声建议改成5×5核Sigma提高到1.2左右。代价是卷积次数从9次变25次但这一层在整条管线里耗时占比不高优先保质量而不是省这点时间。2.2 Sobel梯度计算方向信息决定笔画走向灰度图准备好后下一步计算每个像素的梯度幅值和梯度方向。Sobel算子是这一步的首选两个3×3卷积核分别估计X和Y方向的差分计算量小对噪声的抑制作用比直接差分好输出的梯度方向对后续笔画方向量化也足够准确。static readonly int[,] KernelX new int[,] { { -1, 0, 1 }, { -2, 0, 2 }, { -1, 0, 1 } }; static readonly int[,] KernelY new int[,] { { -1, -2, -1 }, { 0, 0, 0 }, { 1, 2, 1 } }; public static void ComputeGradient(byte[,] gray, int w, int h, out float[,] mag, out float[,] dir) { mag new float[h, w]; dir new float[h, w]; for (int y 1; y h - 1; y) { for (int x 1; x w - 1; x) { float gx 0, gy 0; for (int ky -1; ky 1; ky) { for (int kx -1; kx 1; kx) { byte v gray[y ky, x kx]; gx KernelX[ky 1, kx 1] * v; gy KernelY[ky 1, kx 1] * v; } } mag[y, x] (float)Math.Sqrt(gx * gx gy * gy); dir[y, x] (float)Math.Atan2(gy, gx); } } }这里有个非常容易踩的坐标映射问题。KernelX是左负右正所以gx指向亮度从左到右递增的方向而屏幕坐标系x轴向右、y轴向下Atan2(gy, gx)返回的是一个屏幕坐标系里的向量角度。这影响不大因为后续只关心方向的取向而不关心正负线条方向用垂直向量-gy, gx正负只决定线段从种子点向哪一头延伸不影响画出来的线是否在同一条直线上。真正要注意的是mag的取值范围不固定它取决于图像对比度不是天然落在0-255或0-1区间。如果不做归一化同一阈值在不同图像上得到的线条密度会差出去一倍。我一般会在ComputeGradient返回后多跑一次O(n)的最大值扫描把mag归一化到0-1区间再往下传public static void NormalizeMag(float[,] mag, int w, int h) { float max 0; for (int i 0; i mag.Length; i) if (mag[i] max) max mag[i]; if (max 1e-6f) return; // 全图无边缘直接跳过 for (int i 0; i mag.Length; i) mag[i] / max; }这一步直接决定了后面EdgeThreshold参数能不能做到跨图语义一致。不做归一化时参数调好了这张图换一张对比度低的图就会全部失效是“换图就翻车”的主要来源之一。2.3 笔画聚合把边缘像素连成有方向的有限长线段这是素描生成和Canny拉开差距的一层。Canny做完就是一个二值图像素之间没有“谁和谁是一条线”的语义而素描要有笔触需要把相邻且在方向上连续的边缘像素聚合成一段段笔画。源码里的做法是先按梯度方向把像素分到角度桶默认8个方向每桶45度然后从每个未访问而且幅值过阈值的像素出发沿桶方向向两端延伸延伸过程中允许幅值降到阈值的八成但方向偏离超过1.5个桶距就断线延伸长度上限由StrokeMaxLength控制。public class Stroke { public PointF Start; public PointF End; public float Width; public byte Intensity; } public static ListStroke TraceStrokes(byte[,] gray, float[,] mag, float[,] dir, int w, int h, float thresh, int maxLen, int numDirs) { bool[,] used new bool[h, w]; int bucketAngle 360 / numDirs; var strokes new ListStroke(); for (int y 1; y h - 1; y) { for (int x 1; x w - 1; x) { if (used[y, x] || mag[y, x] thresh) continue; used[y, x] true; float angleDeg dir[y, x] * 180f / (float)Math.PI 90f; // 转到线条延伸方向 angleDeg (angleDeg 360f) % 360f; int bucket (int)(angleDeg / bucketAngle) * bucketAngle; float rad bucket * (float)Math.PI / 180f; float nx (float)Math.Cos(rad), ny (float)Math.Sin(rad); PointF s new PointF(x, y), e new PointF(x, y); // sign1 正向延伸sign-1 反向延伸逻辑完全对称 for (int sign 1; sign -1; sign - 2) { for (int step 1; step maxLen; step) { int cx (int)Math.Round(x sign * nx * step); int cy (int)Math.Round(y sign * ny * step); if (cx 0 || cy 0 || cx w - 1 || cy h - 1) break; if (used[cy, cx]) break; if (mag[cy, cx] thresh * 0.8f) break; float d dir[cy, cx] * 180f / (float)Math.PI 90f; d (d 360f) % 360f; float diff Math.Abs(d - bucket); diff Math.Min(diff, 360f - diff); if (diff bucketAngle * 1.5f) break; used[cy, cx] true; if (sign 0) e new PointF(cx, cy); else s new PointF(cx, cy); } } strokes.Add(new Stroke { Start s, End e, Width 1f, Intensity 255 }); } } return strokes; }这段逻辑里阈值的作用有两个层次。thresh是种子阈值决定哪些像素有资格作为笔画起点延伸时的thresh * 0.8f是延续阈值允许笔画穿过一些稍微弱一点的边缘像素。这种做法比单阈值更符合手绘习惯起笔要干净但笔画一旦起头就允许顺势带过轻微起伏。方向约束diff bucketAngle * 1.5f则是防止一条笔画在拐角处硬转弯手绘里的拐角通常表现为两段笔画相交不是一条线平滑拐过去。如果这里不加约束所有边缘会被连成一条又长又扭曲的蛇形线完全失去笔触感。到这里前三层管线已经完整灰度化、高斯模糊、Sobel梯度、笔画聚合。剩下的是把strokes列表画到白底Bitmap上这一步属于渲染层用Graphics.DrawLine逐条画就行性能开销远小于前面的像素遍历。3. 把代码跑起来SketchOptions 参数结构与四组效果映射原理层讲清楚之后落地最关键的是调参。这套源码把可控参数集中在一个SketchOptions类里调用端不需要碰灰度化和Sobel的细节改四个核心参数就能在“细密铅笔稿”和“干净技术线稿”之间切换。这一章先给最小可跑工程再给参数表和风格组合。3.1 最小可跑工程入口方法与调用顺序把所有前置函数串起来就是一个干净的生成入口。调用方只需要传输入路径、输出路径和参数对象public class SketchOptions { public float EdgeThreshold { get; set; } 0.35f; // 种子阈值相对归一化后的mag public int StrokeMaxLength { get; set; } 12; // 笔画最大延伸像素数 public int Directions { get; set; } 8; // 方向桶数量4或8 public float StrokeWidth { get; set; } 1.2f; // 渲染线宽单位像素 } public static class SketchGenerator { public static void Generate(string inputPath, string outputPath, SketchOptions opt) { using (var src new Bitmap(inputPath)) { byte[,] gray ToGray(src); gray Blur(gray, src.Width, src.Height); ComputeGradient(gray, src.Width, src.Height, out var mag, out var dir); NormalizeMag(mag, src.Width, src.Height); var strokes TraceStrokes(gray, mag, dir, src.Width, src.Height, opt.EdgeThreshold, opt.StrokeMaxLength, opt.Directions); using (var dst new Bitmap(src.Width, src.Height, PixelFormat.Format24bppRgb)) using (var g Graphics.FromImage(dst)) { g.Clear(Color.White); using (var pen new Pen(Color.Black, opt.StrokeWidth)) { foreach (var st in strokes) { g.DrawLine(pen, st.Start, st.End); } } dst.Save(outputPath, ImageFormat.Png); } } } }调用方式就是一个方法调用适合WinForms按钮事件、WPF后台任务或者命令行批量脚本。要注意几件事Bitmap构造函数不校验文件路径是否有效输入路径非法时会在ToGray的LockBits阶段抛异常所以实际项目里入口处要先判断File.Exists。还有TraceStrokes返回的笔画数量在大图上可能达到几十万条Graphics.DrawLine逐条画时需要把Pen缓存起来不要在循环里new Pen否则GDI对象句柄会暴涨这个问题在下一章避坑里详细展开。3.2 四组核心参数分别控制什么参数默认值推荐范围控制内容调大以后的视觉变化EdgeThreshold0.350.15-0.60哪些像素能成为笔画起点线条变少、变干净但轮廓可能缺块StrokeMaxLength124-32单条笔画最大延伸长度线条更连贯但过长会失去手绘断笔感Directions84或8方向桶数量8向更细腻4向容易出现斜线台阶StrokeWidth1.20.5-3.0渲染线宽线越粗越接近粗炭笔细节越容易被吞这里重点讲EdgeThreshold和StrokeMaxLength的相互作用。EdgeThreshold相当于“起笔标准”设高了只有强边缘能起笔画面干净但轻微褶皱、布料纹理全丢掉设低了弱边缘全部参与线条密度暴增。但无论起笔阈值多低StrokeMaxLength都决定了每条笔画能走多远。我常用的经验是EdgeThreshold低于0.2时StrokeMaxLength要同步降到8以下否则弱边缘被连成很长的连续线画面会出现大量超出预期的长弧线看起来像面条。反过来EdgeThreshold高于0.5时StrokeMaxLength可以放到20以上因为能起笔的像素本来就不多长一点反而让轮廓完整。Directions参数容易被忽略但它是个隐形风格开关。默认8方向已经能覆盖多数场景但机械零件图边缘大多是水平和垂直长直线4方向反而更稳能避免斜向45度笔画的抖动人像或风景则必须用8方向4方向会在脸颊、树干这些曲率大的区域留下明显的多边形折线。3.3 常见风格的推荐参数组合风格EdgeThresholdStrokeMaxLengthDirectionsStrokeWidth输出观感细密铅笔稿0.20880.8线条密集层次丰富适合人像干净技术线稿0.502441.5长直线为主适合零件、建筑立面快速草图0.301681.2中等密度折中方案粗炭笔效果0.252082.5线条粗短适合强调光影的主题拿到参数不要直接套到所有图。同一个风格原图分辨率对StrokeMaxLength的影响非常大在4000×3000的大图上12像素的笔画在800×600的小图上相当于一条很长的线。我实际处理时会把StrokeMaxLength按图像最短边做一次换算公式是min(w, h) / 300例如1200×800的图最短边800除以300取整约3默认的12就要缩到3附近否则整张图全是贯穿式长线。这条经验在几种分辨率混批的场景下特别重要。4. 避坑指南素描生成最常见的五个参数与性能翻车任何图像处理管线落地时真正消耗时间的往往不是算法本身而是排查边界情况。这套源码在Windows环境和GDI下有五个高频坑我全部踩过一遍下面按现象、原因、解决写清楚。4.1 现象4000×3000图片处理耗时超过20秒UI线程整个卡死原因是ToGray、Blur、TraceStrokes三层都是同步的像素级遍历加上DrawLine几十万次调用全部在主线程执行时UI完全冻结。解决分两方面第一耗时操作必须搬进后台线程WinForms里用Task.RunWPF里用await Task.RunBitmap的读写放在任务内闭环第二性能本身也要优化重点是DrawLine这一层。笔画数量在20万条时逐条DrawLine的耗时占比接近总耗时40%改成按线宽分组、用Graphics.DrawLines批量绘制耗时能降到逐条调用的三分之一。// 按线宽分组后批量绘制减少 GDI 状态切换 var groups strokes.GroupBy(s s.Width); foreach (var grp in groups) { using (var pen new Pen(Color.Black, grp.Key)) { var pts grp.SelectMany(s new[] { s.Start, s.End }).ToArray(); g.DrawLines(pen, pts); // 一次调用画完一组 } }4.2 现象输出线条断成碎点看不出完整轮廓这是EdgeThreshold设置过高加上延伸阈值系数的问题。阈值定死在高位种子点太少每条线都起不了头。另一个隐藏原因是TraceStrokes里延续阈值用thresh * 0.8f这个固定系数限制了笔画穿过弱边缘的能力。解决是先统计mag分布把EdgeThreshold设到mag直方图80分位附近而不是凭感觉给0.35或0.5同时把延续阈值系数从0.8放宽到0.6让起笔后的笔画有更大机会跨过中间弱响应区。注意放宽后线条密度会增加配合StrokeMaxLength适当加大轮廓就能恢复完整。4.3 现象线条方向出现明显的45度或90度台阶感Directions设为4时笔画只能沿0、90、180、270四个方向走斜向轮廓会变成阶梯状折线。解决是换8方向甚至16方向。但Directions增大后还有第二个问题方向桶变细笔画更容易因为方向抖动而提前断线。所以从4改到8时最好同时把方向容差从1.5个桶距放宽到2个桶距这是连续调整不是单点开关。4.4 现象同一个参数在不同图片上结果差异巨大原因几乎都在归一化。如果ComputeGradient之后没有做NormalizeMag不同图的对比度差距直接迁移到阈值上。解决就是强制归一化并用相对值而不是绝对值调参。我习惯在SketchGenerator里留一个Debug输出每张图处理时把mag最大值、归一化后的均值、低于阈值的像素占比打到日志换图跑的时候对比这三个数能很快定位是参数问题还是图像本身问题。4.5 现象内存占用暴涨序列图批量处理时OOMBitmap没有及时释放加上Pen句柄泄漏是常见元凶。using能管住Bitmap但Pen如果在foreach里逐条new句柄会堆积到系统层GDI对句柄数的限制最终让绘制静默失败。解决就是前面说的分组批量画法Pen按组创建并用using释放LockBits和UnlockBits必须在同一个方法作用域里紧凑成对中间任何return或异常都要保证UnlockBits执行最稳妥的是把LockBits后的操作包在try/finally里或者干脆封装到方法内部不让外部拿到未解锁的Bitmap。5. 进阶技巧纸张纹理叠加与覆盖率回归验证最后讲两个在实际项目中立刻能用上的小技巧一个是让输出更像“纸上的铅笔稿”一个是给管线增加客观验证手段。5.1 纸张纹理叠加纯白底加黑线观感更像CAD打印稿不像素描。要接近真实素描纸质感常见做法是把一张浅灰噪点纹理图和线条稿做乘法叠加公式是dst base * texture / 255。C#里两次遍历就能完成// 纹理图为灰度图与线条稿逐像素相乘模拟铅笔在纸上的附着 for (int y 0; y h; y) { for (int x 0; x w; x) { int line linePixels[y, x]; int tex texPixels[y, x]; linePixels[y, x] (byte)(line * tex / 255); } }纹理图建议用低频噪声生成别直接用均匀随机噪声否则叠加后颗粒感会非常重。低频噪声的构造方法是先生成一张小尺寸随机图再双三次插值放大到目标尺寸。这样得到的纹理有自然的团状明暗更接近纸张纤维分布。5.2 覆盖率回归验证素描调参很容易陷入“肉眼看着差不多就行”但生成结果可以用一个客观指标衡量边缘覆盖率。做法是先生成一张参考二值边缘图比如高阈值的Canny结果再统计素描笔画像素中落在参考边缘3×3邻域内的比例// 覆盖率 落在参考边缘 3x3 邻域内的笔画像素数 / 笔画像素总数 float coverage hitCount / (float)totalStrokePixels;覆盖率太高说明线条只是贴边描线太低说明线条已经偏离真实边缘是风格化过头了。我一般把0.6到0.85这个区间作为有效范围低于0.6就回头检查方向量化和StrokeMaxLength。从那以后我每次改参数都会顺手跑一遍覆盖率统计和一张中间图强制自己先看数据再动参数而不是凭感觉来回试。特别是批量处理几十张图时这个习惯能省掉大量复查时间希望帮到你。本文还有配套的精品资源点击获取
