aafigure(1)

NAME

aafigure - convert ASCII art to an image

SYNOPSIS

aafigure [option...] [input-file]

aafigure {-h | --help | --version}

DESCRIPTION

aafigure is an ASCII art to image converter.

ASCII art figures can be parsed and output as SVG, PNG, PDF and more.

OPTIONS

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:

F

East Asian Fullwidth

H

East Asian Halfwidth

W

East Asian Wide

Na

East Asian Narrow

A

East Asian Ambiguous

N

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.

--proportional

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.

--version

Display version information and exit.

AUTHOR

Jakub Wilk <[email protected]>

COPYRIGHT

Copyright © 2009, 2010 Jakub Wilk

NOTES

1.

East Asian width

http://www.unicode.org/reports/tr11/