手册

概述

最初的想法是解析嵌入到REST文档中的ASCII艺术图像并输出图像。这意味着简单的插图可以作为ASCII图片嵌入到REST源代码中，并且在转换为例如HTML时仍然很好看。

Aafigure可用于编写包含纯文本文档中的图形的文档，并且这些图形被转换为适当的格式，例如同一文档的HTML或PDF版本。

从那时起，aafigure也发展成为一个独立的应用程序，为ASCII图片到图像的转换提供了命令行工具。

ASCII艺术

术语“ASCII艺术”描述了一种 wide field 。

• (小)在电子邮件签名中找到的图形

• 微笑：-)

• 栅格图像(这是在纯文本打印机上打印图像的流行方式 few 几年前)

• 使用线条、矩形、箭头的简单图表

Aafigure的目标是解析最后一种类型的图表。

其他文本转图像工具

当然，还有很多其他工具可以进行某种形式的文本到图像的转换。主要区别之一是，其他工具通常使用描述语言从规则生成图像。这是与Aafigure的主要区别，Aafigure的目标是将文本文件中好看的图表/图像等转换为位图或矢量图形等更好看的图像。以下是一些例子(绝不是一个完整的列表)：

Graphviz

Graphviz是一款非常流行的工具，非常适合显示图形和网络。它通过读取节点之间的关系列表来实现这一点，并自动找到以视觉上吸引人的方式放置所有节点的最佳方式。

这与aafigure有很大不同，两者都有自己的长处。Graphviz非常适合文档状态机、类层次结构和其他图形。

Mscgen

一种专门用于序列图的工具(用于描述软件，即UML)。

ditaa

将图表转换为图像。

安装

aafigure

pip install aafigure

这将安装一个可从python使用的包。 (import aafigure )和一个名为 aafigure 。

当需要支持位图格式时，需要安装Python成像库(PIL)，并且需要ReportLab才能进行PDF输出。

要求

• reportlab (用于LaTeX/PDF输出)

• PIL 或 Pillow (适用于除SVG或PDF以外的任何图像格式)

用法

命令行工具

aafigure test.txt -t png -o test.png

该工具还可以从标准输入读取，并支持许多选项。请查看命令的帮助(或手册页)：：

aafigure --help