Man Linux: Main Page and Category List


       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

       This manual page was written for the Debian system (and may be used by

       Permission is granted to copy, distribute and/or modify this document
       under the terms of the GNU General Public License Version 2, as
       published by the Free Software Foundation.

       On Debian systems, the complete text of the GNU General Public License
       Version 2 can be found in /usr/share/common-licenses/GPL-2.


        1. East Asian width