将图片转换为黑底、等宽字符画。字符按字体的六维形状向量匹配,并用有符号 DoG 锐化和 Sobel 方向特征保留轮廓。
Rust 1.85 或更高版本(edition 2024)。
cargo build --release
./target/release/ascii-image-studio photo.jpg字体已内嵌,运行时不依赖系统字体。终端输出未指定 --width 时取窗口列数;输出到文件或重定向时默认 160 列。
./target/release/ascii-image-studio photo.jpg --braille --dither --color -o portrait.png| 参数 | 默认值 | 说明 |
|---|---|---|
-w, --width |
终端宽度 / 160 | 输出字符列数;显式值优先 |
-o, --output |
终端 | 输出文件;扩展名决定格式 |
-c, --contrast |
1.3 |
对比度幂指数,作用于色调映射后的亮度 |
--tone-map |
clahe |
clahe 局部均衡;global 全局 1%–99% 拉伸(旧版色调曲线) |
-d, --dir-crunch |
2.5 |
外部邻域方向锐化指数 |
-e, --edge-weight |
0.25 |
有符号 DoG 锐化权重;0 表示关闭 |
--dither |
关闭 | ASCII 用 Floyd–Steinberg;盲文用 2x4 Bayer 有序抖动 |
--refine |
关闭 | 网格级 top-5 局部搜索;与 --dither、--braille 互斥 |
--aiss |
关闭 | AISS 边缘描述子重排 6D 前 10 名;弱边缘或空白单元回退纯 6D,与 --dither、--braille、--refine 互斥 |
--color |
关闭 | 保留原图高亮区域颜色 |
--braille |
关闭 | 使用 2x4 盲文点阵字符 |
- 默认
--tone-map clahe按块限幅(clip limit 2.0)并重分配直方图,再插值消除块边界。低对比或噪点明显的图片可改用global。 --contrast在色调映射之后生效,两种模式语义相同。- 黑白输出的字符亮度按单元真实亮度调制为
0.25 + 0.75 * Y_cell,暗处字符不会保持纯白。--color保留真实 RGB,不做这层调制。 -e使用有符号 DoG 非锐化掩模,边缘亮侧更亮、暗侧更暗;Sobel 只提供方向和边缘强度。--refine以 6D 匹配为初值,用 3x3 单元 HVS、全局密度漂移和沿边密度平滑做 3 轮棋盘重选;不使用 Floyd–Steinberg。--aiss首次使用时为每个字符构建对数极坐标边缘直方图;字形覆盖图与目标单元都经过同一套 10x20 DoG 边缘算子。单元边缘的绝对平均幅值达到门限时,在 6D 前 10 名内按直方图 L1 距离重排;弱边缘或空白单元保持纯 6D。- 盲文没有字形方向选择,
--dir-crunch只影响 ASCII 字符匹配。 - 透明像素先合成到黑底。
| 扩展名 | 内容 |
|---|---|
.txt |
纯文本,无 ANSI 转义序列 |
.ans |
24-bit ANSI,黑底前景色 |
.png |
黑底无损图片,每字符格 10x20 像素 |
| 终端 | 24-bit ANSI,黑底前景色 |
盲文 PNG 按标准 2x4 点阵位图绘制,不依赖字体盲文字形。
输入同为逆光风景(CC0),-w 80:
| 原图 | 标准 ASCII | 彩色 | 盲文 |
|---|---|---|---|
![]() |
![]() |
![]() |
![]() |
彩色示例使用 --color,盲文示例使用 --braille --dither。
scripts/compare-grid.sh photo.jpg 生成 --dir-crunch 与 --edge-weight 的 3x3 拼图,输出 output/compare/<图片名>/grid.png。拼图需要 Python 3 与 Pillow,仅用于开发比较。
python3 scripts/eval.py 运行固定的 P0 评测基线,结果写入 target/eval/results.json 和 docs/eval-baseline.md。评测依赖固定版本:
python3 -m pip install -r scripts/requirements-eval.txtCI 在推送和拉取请求时运行 cargo fmt --check、cargo clippy --all-targets --all-features -- -D warnings、cargo test --all-targets --all-features,并构建 Linux x86_64、macOS arm64、macOS x86_64、Windows x86_64 四个平台的二进制。工作流定义见 .github/workflows/ci.yml。
内嵌字体为 JetBrains Mono Regular,按 SIL Open Font License 1.1 使用。许可证见 assets/OFL.txt。
scripts/eval.py 的 FSIM 指标移植自 FeatureSIM.m。该部分按上游条款仅用于教育/研究用途,不适用本仓库的 MIT 许可,商用前需取得原作者许可。全文见 scripts/NOTICE-eval.md。
示例图片取自 Wikimedia Commons:
- 人像:Migrant Mother,作者 Dorothea Lange(美国国会图书馆),Public domain。
- 线稿:Main facade Cathedral of Burgos 1850 Villaamil,绘图 Genaro Pérez Villaamil;版画 Charles Claude Bachelier;1850,Public domain(PD-old-100、PD-Scan)。
- 风景:Backlit Margarita Island Sunset in Las Guevaras, Venezuela,作者 Wilfredor,CC0 1.0。
docs/ 下的图片由这些样本渲染拼接,许可同上。



