aafigure.1

.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.38.4.
.TH AAFIGURE "1" "December 2011" "aafigure 0.5" "User Commands"
.SH NAME
aafigure - ASCII art to image converter
.SH SYNOPSIS
.B aafigure
[\fIoptions\fR] [\fIfile\fR]
.SH DESCRIPTION
ASCII art to image (SVG, PNG, JPEG, PDF and more) converter.
.PP
aafigure is a command line tool that converts drawings in text files to images. Several output formats are supported (SVG, PDF, PNG, JPG and more).

Note that PDF output requires the Reportlab Python library and bitmap formats
require the Python Imaging Library (PIL).
.SH OPTIONS
.TP
\fB\-\-version\fR
show program's version number and exit
.TP
\fB\-h\fR, \fB\-\-help\fR
show this help message and exit
.TP
\fB\-e\fR ENCODING, \fB\-\-encoding\fR=\fIENCODING\fR
character encoding of input text
.TP
\fB\-w\fR WIDECHARS, \fB\-\-wide\-chars\fR=\fIWIDECHARS\fR
unicode properties to be treated as wide glyph (e.g.
\&'F,W,A')
.TP
\fB\-o\fR FILE, \fB\-\-output\fR=\fIFILE\fR
write output to FILE
.TP
\fB\-t\fR FORMAT, \fB\-\-type\fR=\fIFORMAT\fR
filetype: png, jpg, svg (by default autodetect from
filename)
.TP
\fB\-D\fR, \fB\-\-debug\fR
enable debug outputs
.TP
\fB\-T\fR, \fB\-\-textual\fR
disable horizontal fill detection
.TP
\fB\-S\fR, \fB\-\-textual\-strict\fR
disable horizontal and vertical fill detection
.TP
\fB\-s\fR SCALE, \fB\-\-scale\fR=\fISCALE\fR
set scale
.TP
\fB\-a\fR ASPECT, \fB\-\-aspect\fR=\fIASPECT\fR
set aspect ratio
.TP
\fB\-l\fR LINE_WIDTH, \fB\-\-linewidth\fR=\fILINE_WIDTH\fR
set width, svg only
.TP
\fB\-\-proportional\fR
use proportional font instead of fixed width
.TP
\fB\-f\fR FOREGROUND, \fB\-\-foreground\fR=\fIFOREGROUND\fR
foreground color default=#000000
.TP
\fB\-x\fR FILL, \fB\-\-fill\fR=\fIFILL\fR
foreground color default=foreground
.TP
\fB\-b\fR BACKGROUND, \fB\-\-background\fR=\fIBACKGROUND\fR
foreground color default=#ffffff
.TP
\fB\-O\fR _EXTRA_OPTIONS, \fB\-\-option\fR=\fI_EXTRA_OPTIONS\fR
pass special options to backends (expert user)
.SH EXAMPLES
Convert a drawing to a PDF file:

    aafigure drawing.txt -o drawing.pdf

Read from stdin and output a PNG image on stdout:

    aafigure -t png
.SH AUTHOR
aafigure-team: http://launchpad.net/aafigure
.SH "REPORTING BUGS"
Please report bugs at http://bugs.launchpad.net/aafigure
.SH COPYRIGHT
Copyright \(co 2006\-2011 aafigure\-team
.PP
Redistribution and use in source and binary forms, with or without
modification, are permitted under the terms of the BSD License.
.PP
THIS SOFTWARE IS PROVIDED BY THE AAFIGURE\-TEAM ''AS IS'' AND ANY
EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE AAFIGURE\-TEAM BE LIABLE FOR ANY
DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.