137 lines
3.5 KiB
Markdown
137 lines
3.5 KiB
Markdown
# 图片转SVG工具
|
||
|
||
将图片中的黑色部分提取并转换为高保真 SVG，基于 `potrace` 描边以保证准确还原。
|
||
|
||
## 功能特点
|
||
|
||
- 自动提取黑色区域（Otsu 自动阈值）
|
||
- 透明通道白底合成，避免边缘污染
|
||
- `potrace` 高精度矢量化，支持孔洞
|
||
- 默认保真优先（关闭曲线优化）
|
||
- 支持圆拟合简化（近似圆轮廓可替代为圆弧）
|
||
|
||
## 安装依赖
|
||
|
||
```bash
|
||
pip install -r requirements.txt
|
||
```
|
||
|
||
### 安装 potrace（必需）
|
||
|
||
```bash
|
||
brew install potrace
|
||
```
|
||
|
||
### 字体转SVG依赖
|
||
|
||
用于 `font2svg.py`（字形轮廓输出）：
|
||
|
||
```bash
|
||
pip install fonttools uharfbuzz
|
||
```
|
||
|
||
## 使用方法
|
||
|
||
### 基本用法
|
||
|
||
```bash
|
||
python pic2svg.py input.png
|
||
```
|
||
|
||
这将在同一目录生成 `input.svg` 文件。
|
||
|
||
### 指定输出目录
|
||
|
||
```bash
|
||
python pic2svg.py input.png --outdir svg
|
||
```
|
||
|
||
### 常用参数示例
|
||
|
||
```bash
|
||
# 使用固定阈值
|
||
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（新脚本）
|
||
|
||
```bash
|
||
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） | - |
|
||
|
||
## 批量转换
|
||
|
||
```bash
|
||
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
|