技能介绍

解决的问题

把位图变成笔式绘图仪能跑的路径，中间通常要跨过三道坎：一是图片本身有噪点、对比度不足，直接矢量化会产出碎边和毛刺；二是 SVG 里的曲线要转成绘图仪认识的抬笔、落笔、进给指令；三是坐标单位要从像素换算到毫米。这个技能把这条链路做成了固定管线，输入一张图片，输出同目录下的 .svg 与 .gcode。

工作方式

核心流程分几步：

保存输入：save_image.py 把上传的图片复制到当前工作目录，重命名为 _input_ 前缀的文件名。
图像预处理与矢量化：img2svg.py 先做高斯模糊和 CLAHE 对比度增强，再自适应二值化，用形态学开闭运算去噪，最后调用 potrace 生成平滑曲线。
路径转换：svg2gcode.py 把 SVG 路径转成 G 代码，绘图参数集中在脚本顶部，例如 SCALE 控制像素到毫米的缩放，PEN_UP_Z 和 PEN_DOWN_Z 分别定义抬笔高度与落笔深度，FEED_MOVE 与 FEED_DRAW 区分空驶速度和绘制速度。
结果落地：run.py 串联上述步骤，运行结束后自动打开输出文件夹。

适用边界

依赖 opencv-python、numpy、svgpathtools 三个 Python 包，以及 potrace.exe，缺少后者管线无法完成矢量化。
默认 SCALE 为 0.0018，对应常见图片分辨率；图片尺寸或画幅变化时需要重新校准，否则输出尺寸会偏大或偏小。
输出是绘图路径而非成品图像，线条密度取决于二值化阈值，大面积渐变区域容易出现阶梯状断层。
Y 轴方向默认做了翻转，对接不同型号绘图仪时需确认坐标系是否一致。