TopoGlyph

图像

1. 拖入或选择一张图片。
2. 首次使用请将字符集保持为Lines — 这是唯一无需上传任何文件即可使用的选项。ASCII / Blocks / Braille / Custom 都会用你提供的字体来栅格化字符，因此选了这些字符集却没有在其下方选择“字体文件 (TTF/OTF)”，是最常见的 Render 报错“needs a font file”的原因。系统里的任何 TTF/OTF 都可以。
3. 点击Render。调整 Columns / Rows / Tolerance / Chaikin 后重新渲染，直到满意。
4. Copy Text 复制原始字符（适用于任何字符集）；Download .txt 保存到文件。

视频 / GIF

1. 拖入视频或动态 GIF。一切都在你的浏览器里完成 — 没有服务器、没有 FFmpeg；帧通过浏览器原生 <video>/<canvas> 元素抓取，所以浏览器本来无法播放的编码在这里也无法解码。
2. 字符集规则与图像相同：非“Lines”字符集需要字体文件。
3. Sample FPS 控制每秒转换源视频的帧数 — 数值越高耗时越长，生成的 .tglyph 文件也越大。
4. 点击Convert，然后在 Playback 面板点击Play预览结果，或Download .tglyph 把动画保存为纯文本文件（参见 .tglyph 格式）。

字形图集

选择一个字符集（字体要求同上）并点击Inspect，即可查看每个候选字形的笔画掩码、边界端口和匹配特征 — 有助于理解渲染为何选择了这些字符。

参数指南

• 字符集 (Charset): 使用的“调色板”。Lines/ASCII/Blocks/Braille 都是内置的，无需字体。只有选 Custom 时才需要上传字体文件。
• 匹配预设 (Preset): Line Art 关注线条的拓扑连接；Han / Emoji 关注像素墨水密度，表现更圆润。
• 列数 (Columns): 留空为自动适应。填入更大的数字（如 150-200）能获得原图级别的超高分辨率。
• RDP / Chaikin: 轮廓提取前处理。Chaikin 调到 2 或 3 会让提取出的曲线更加圆滑。
• Top-K / Relaxation: 控制匹配算法在相邻网格间寻找平滑过渡的能力。