---
name: "aafigure"
section: "1"
platform: "linux"
package: "python-aafigure"
version: "0.5-7"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/aafigure"
---

# aafigure(1)

convert ASCII art to an image

## 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** \<jwilk@debian.org\>

Wrote this manpage for the Debian system.

## COPYRIGHT

Copyright © 2009, 2010 Jakub Wilk\

## NOTES

- 1\.

  East Asian width

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