'\" t
.\"     Title: aafigure
.\"    Author: Jakub Wilk <jwilk@debian.org>
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\"      Date: 07/19/2019
.\"    Manual: aafigure manual
.\"    Source: aafigure 0.5
.\"  Language: English
.\"
.TH "AAFIGURE" "1" "07/19/2019" "aafigure 0\&.5" "aafigure manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
aafigure \- convert ASCII art to an image
.SH "SYNOPSIS"
.HP \w'\fBaafigure\fR\ 'u
\fBaafigure\fR [\fIoption\fR...] [\fIinput\-file\fR]
.HP \w'\fBaafigure\fR\ 'u
\fBaafigure\fR {\fB\-h\fR | \fB\-\-help\fR | \fB\-\-version\fR}
.SH "DESCRIPTION"
.PP
\fBaafigure\fR
is an ASCII art to image converter\&.
.PP
ASCII art figures can be parsed and output as SVG, PNG, PDF and more\&.
.SH "OPTIONS"
.PP
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\&.
.PP
\fB\-o\fR, \fB\-\-output=\fR\fB\fIfile\fR\fR
.RS 4
Write output to
\fIfile\fR
rather than to the standard output\&.
.RE
.PP
\fB\-e\fR, \fB\-\-encoding=\fR\fB\fIencoding\fR\fR
.RS 4
Set character encoding for input text\&. The default is \(oqUTF\-8\(cq\&.
.RE
.PP
\fB\-w\fR, \fB\-\-wide\-chars=\fR\fB\fIproperties\fR\fR
.RS 4
Specify which characters should be considered wide\&.
\fIproperties\fR
is a comma\-separated list of
\m[blue]\fBEast Asian width\fR\m[]\&\s-2\u[1]\d\s+2
symbols:
.PP
F
.RS 4
East Asian Fullwidth
.RE
.PP
H
.RS 4
East Asian Halfwidth
.RE
.PP
W
.RS 4
East Asian Wide
.RE
.PP
Na
.RS 4
East Asian Narrow
.RE
.PP
A
.RS 4
East Asian Ambiguous
.RE
.PP
N
.RS 4
Neutral (Not East Asian)
.RE
.sp
The default is \(oqF,W\(cq\&.
.RE
.PP
\fB\-t\fR, \fB\-\-type=\fR\fB\fIformat\fR\fR
.RS 4
Use the provided output format\&. By default, output format is inferred from the output file name extension\&.
.sp
The following formats are supported: SVG, PDF, PNG and any file format supported by Python Imaging Library\&.
.RE
.PP
\fB\-D\fR, \fB\-\-debug\fR
.RS 4
Enable debug outputs\&.
.RE
.PP
\fB\-T\fR, \fB\-\-textual\fR
.RS 4
Disable horizontal fill detection\&.
.RE
.PP
\fB\-s\fR, \fB\-\-scale=\fR\fB\fIscale\fR\fR
.RS 4
Use the specified scale\&.
.RE
.PP
\fB\-a\fR, \fB\-\-aspect=\fR\fB\fIaspect\fR\fR
.RS 4
Use the specified aspect ratio\&.
.RE
.PP
\fB\-l\fR, \fB\-\-line\-width=\fR\fB\fIwidth\fR\fR
.RS 4
For SVG output format, use the specified line width\&.
.RE
.PP
\fB\-\-proportional\fR
.RS 4
Use a proportional font rather than a fixed\-width font\&.
.RE
.PP
\fB\-f\fR, \fB\-\-foreground=#\fR\fB\fIrrggbb\fR\fR
.RS 4
Use the specified foreground color\&. The default is black (#000000)\&.
.RE
.PP
\fB\-x\fR, \fB\-\-fill=#\fR\fB\fIrrggbb\fR\fR
.RS 4
Use the specified fill color\&. The default is the foreground color\&.
.RE
.PP
\fB\-b\fR, \fB\-\-background=#\fR\fB\fIrrggbb\fR\fR
.RS 4
Use the specified background color\&. The default is white (#ffffff)\&.
.RE
.PP
\fB\-O\fR, \fB\-\-option=\fR\fB\fIextra\-options\fR\fR
.RS 4
Pass special options to backends\&. (For expert users only\&.)
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
Display help and exit\&.
.RE
.PP
\fB\-\-version\fR
.RS 4
Display version information and exit\&.
.RE
.SH "AUTHOR"
.PP
\fBJakub Wilk\fR <\&jwilk@debian\&.org\&>
.RS 4
Wrote this manpage for the Debian system\&.
.RE
.SH "COPYRIGHT"
.br
Copyright \(co 2009, 2010 Jakub Wilk
.br
.SH "NOTES"
.IP " 1." 4
East Asian width
.RS 4
\%http://www.unicode.org/reports/tr11/
.RE