Skip to content

About

Terminal-style ASCII art generator from images, written in Rust | 将照片转换为终端风格的 ASCII 字符画

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

22 Commits

Folders and files

Repository files navigation

ASCII Image Studio

将图片转换为黑底、等宽字符画。字符按字体的六维形状向量匹配,并用有符号 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 彩色 盲文
原图 标准 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.txt

CI 在推送和拉取请求时运行 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:

docs/ 下的图片由这些样本渲染拼接,许可同上。

About

Terminal-style ASCII art generator from images, written in Rust | 将照片转换为终端风格的 ASCII 字符画

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages