图片转SVG工具

将图片中的黑色部分提取并转换为高保真 SVG，基于 potrace 描边以保证准确还原。

功能特点

• 自动提取黑色区域（Otsu 自动阈值）
• 透明通道白底合成，避免边缘污染
• potrace 高精度矢量化，支持孔洞
• 默认保真优先（关闭曲线优化）
• 支持圆拟合简化（近似圆轮廓可替代为圆弧）

安装依赖

pip install -r requirements.txt

安装 potrace（必需）

brew install potrace

字体转SVG依赖

用于 font2svg.py（字形轮廓输出）：

pip install fonttools uharfbuzz

使用方法

基本用法

python pic2svg.py input.png

这将在同一目录生成 input.svg 文件。

指定输出目录

python pic2svg.py input.png --outdir svg

常用参数示例

# 使用固定阈值
python pic2svg.py input.png --threshold 128

# 保真优先（默认参数）
python pic2svg.py input.png --turdsize 0 --opttolerance 0 --unit 1

# 文件更小（可能略失真）
python pic2svg.py input.png --optimize-curves --opttolerance 0.2

# 圆拟合简化（仅当轮廓接近圆时生效）
python pic2svg.py input.png --circle-fit 0.02

# 批量转换（输入目录）
python pic2svg.py --indir images --outdir svg

字体转SVG（新脚本）

python font2svg.py --font path/to/font.ttf --text "Hello"
python font2svg.py --font font/XCDUANZHUANGSONGTI.ttf --text "星程紫微" --outdir svg
python font2svg.py --font path/to/font.ttf --text "Hello" --letter-spacing 20
python font2svg.py --fontdir font --text "星程紫微" --outdir svg

说明：单字体输出文件名根据 --text 自动生成；使用 --fontdir 时会加上字体名作为前缀。

参数说明

参数	说明	默认值
input	输入图片路径（必需）	-
--indir	输入目录（批量转换）	-
--outdir	输出目录（自动创建，使用输入文件名.svg）	-
--threshold	固定阈值（0-255），未设置则使用Otsu	-
--turdsize	抑制噪点面积阈值（potrace -t）	0
--opttolerance	曲线优化容差（potrace -O）	0.0
--unit	坐标量化单位（potrace -u）	1
--optimize-curves	启用曲线优化（更小但可能略失真）	关闭
--circle-fit	圆拟合误差阈值（相对半径），>0启用圆替代	0.0

font2svg 参数说明

参数	说明	默认值
--font	字体文件路径（ttf/otf）	-
--text	文字内容	-
--outdir	输出目录（自动创建）	-
--letter-spacing	字距（字体单位）	0
--fontdir	字体目录（遍历ttf/otf）	-

批量转换

python pic2svg.py --indir images --outdir output

工作原理

1. 读取图像，透明通道白底合成
2. 灰度化 + Otsu 反色二值化
3. 若启用 --circle-fit，先尝试圆拟合替代
4. 写入 PBM 位图
5. potrace 描边生成 SVG（圆拟合失败时回退）

故障排除

细节缺失或断裂：降低 turdsize，关闭 --optimize-curves，必要时设置更合适的 --threshold。

文件过大：开启 --optimize-curves 或适当增大 --opttolerance。

边缘毛刺：尝试调整 --threshold，或先对原图做轻微去噪。

圆拟合过于粗糙：减小 --circle-fit 或关闭圆拟合。

技术栈

• Python 3.6+
• OpenCV / NumPy
• potrace
• fonttools / uharfbuzz

License

MIT