first commit

README.md

@@ -0,0 +1,136 @@
+# 图片转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