位图转矢量

技能简介

trace-to-svg 调用 potrace 与 mkbitmap 工具，将 PNG、JPG、WebP 等位图转换为干净的 SVG 路径文件。适合处理标志、剪影等高对比度图形，为下游 CAD 流程（如 create-dxf 的 etch_svg_path）提供可制造的轮廓数据。

能做什么

• 把位图 Logo 转为可缩放矢量路径
• 生成剪影轮廓用于激光切割或蚀刻
• 为 CAD 工作流准备标准 SVG 输入
• 通过参数调节控制噪点与边缘平滑度

使用说明

安装依赖

# Debian/Ubuntu
sudo apt install potrace

# macOS
brew install potrace

基本用法

# 生成基础 SVG
bash scripts/trace_to_svg.sh input.png --out out.svg

# 提高对比度、减少噪点
bash scripts/trace_to_svg.sh input.png --out out.svg --threshold 0.6 --turdsize 20

接入 CAD 流程

将输出的 SVG 路径 d 属性填入 create-dxf 的 drawing.etch_svg_paths 配置，或直接引用 SVG 文件继续后续加工。

输入与输出

见下方输入与输出表格。

风险提示

• 照片或复杂渐变图像需反复调试阈值，结果不稳定
• 默认输出为单一路径元素，多色图层需分批处理
• mkbitmap 预处理会丢失色彩信息，仅保留明暗轮廓
• 极低分辨率输入可能产生锯齿或断裂路径

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/ajmwagar/trace-to-svg/SKILL.md
来源类型：GitHub 仓库