Man pages sections > man1 > aafigure

aafigure - convert ASCII art to an image

AAFIGURE(1) aafigure manual AAFIGURE(1)


aafigure - convert ASCII art to an image


aafigure [ option...] [input-file]
aafigure { -h | --help | --version}


aafigure is an ASCII art to image converter.
ASCII art figures can be parsed and output as SVG, PNG, PDF and more.


The program follows the usual GNU command line syntax, with long options starting with two dashes (--). Mandatory or optional arguments to long options are also mandatory or optional for any corresponding short options.
-o, --output=file
Write output to file rather than to the standard output.
-e, --encoding=encoding
Set character encoding for input text. The default is ‘UTF-8’.
-w, --wide-chars=properties
Specify which characters should be considered wide. properties is a comma-separated list of East Asian width[1] symbols:
East Asian Fullwidth
East Asian Halfwidth
East Asian Wide
East Asian Narrow
East Asian Ambiguous
Neutral (Not East Asian)
The default is ‘F,W’.
-t, --type=format
Use the provided output format. By default, output format is inferred from the output file name extension.
The following formats are supported: SVG, PDF, PNG and any file format supported by Python Imaging Library.
-D, --debug
Enable debug outputs.
-T, --textual
Disable horizontal fill detection.
-s, --scale=scale
Use the specified scale.
-a, --aspect=aspect
Use the specified aspect ratio.
-l, --line-width=width
For SVG output format, use the specified line width.
Use a proportional font rather than a fixed-width font.
-f, --foreground=#rrggbb
Use the specified foreground color. The default is black (#000000).
-x, --fill=#rrggbb
Use the specified fill color. The default is the foreground color.
-b, --background=#rrggbb
Use the specified background color. The default is white (#ffffff).
-O, --option=extra-options
Pass special options to backends. (For expert users only.)
-h, --help
Display help and exit.
Display version information and exit.


Jakub Wilk <>
Wrote this manpage for the Debian system.
Copyright © 2009, 2010 Jakub Wilk


East Asian width
08/18/2015 aafigure 0.5