使用示例与说明

🚀 快速开始

1. 安装依赖

pip install -r requirements.txt

2. 安装 potrace（必需）

brew install potrace

2.1 字体转SVG依赖

pip install fonttools uharfbuzz

3. 转换单个文件

python pic2svg.py images/your_image.png

3.1 指定输出目录

python pic2svg.py images/your_image.png --outdir output/

4. 批量转换

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

5. 字体转SVG

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

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

⚙️ 参数说明

--threshold：固定阈值（0-255），默认使用 Otsu 自动阈值。
--indir：输入目录（批量转换）。
--outdir：输出目录（自动创建，使用输入文件名.svg）。
--turdsize：抑制噪点面积阈值，越小保留细节越多。
--opttolerance：曲线优化容差，越大文件越小但可能失真。
--unit：坐标量化单位，1 表示不量化。
--optimize-curves：开启曲线优化（更小但可能略失真）。
--circle-fit：圆拟合误差阈值（相对半径），>0 启用圆替代。
--font：字体文件路径（ttf/otf）。
--fontdir：字体目录（遍历ttf/otf）。
--text：文字内容。
--letter-spacing：字距（字体单位），默认 0。

🧩 常用配置示例

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

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

# 需要固定阈值时
python pic2svg.py images/your_image.png --threshold 128

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

# 批量转换
python pic2svg.py --indir images --outdir output

🐛 常见问题

Q: 细节丢失或断裂？
A: 降低 --turdsize，关闭 --optimize-curves，必要时指定 --threshold。

Q: SVG 太大？
A: 开启 --optimize-curves，或适当增大 --opttolerance。

Q: 能否处理彩色图？
A: 当前流程会转为灰度并二值化，只保留黑色区域。

Q: 圆拟合过于粗糙？
A: 减小 --circle-fit 或关闭圆拟合。

📄 License

MIT License - 自由使用和修改

2.7 KiB Raw Blame History Unescape Escape