AAFIGURE(1)

NAME
aafigure - ASCII art to image converter

SYNOPSIS
aafigure [options] [file]

DESCRIPTION
ASCII art to image (SVG, PNG, JPEG, PDF and more) converter.

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).

OPTIONS

--version
    show program's version number and exit

-h, --help
    show this help message and exit

-e ENCODING, --encoding=ENCODING
    character encoding of input text

-w WIDECHARS, --wide-chars=WIDECHARS
    unicode properties to be treated as wide glyph (e.g. 'F,W,A')

-o FILE, --output=FILE
    write output to FILE

-t FORMAT, --type=FORMAT
    filetype: png, jpg, svg (by default autodetect from filename)

-D, --debug
    enable debug outputs

-T, --textual
    disable horizontal fill detection

-S, --textual-strict
    disable horizontal and vertical fill detection

-s SCALE, --scale=SCALE
    set scale

-a ASPECT, --aspect=ASPECT
    set aspect ratio

-l LINE_WIDTH, --linewidth=LINE_WIDTH
    set width, svg only

--proportional
    use proportional font instead of fixed width

-f FOREGROUND, --foreground=FOREGROUND
    foreground color default=#000000

-x FILL, --fill=FILL
    foreground color default=foreground

-b BACKGROUND, --background=BACKGROUND
    foreground color default=#ffffff

-O _EXTRA_OPTIONS, --option=_EXTRA_OPTIONS
    pass special options to backends (expert user)

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

AUTHOR
aafigure-team: http://launchpad.net/aafigure

REPORTING BUGS
Please report bugs at http://bugs.launchpad.net/aafigure

COPYRIGHT
Copyright © 2006-2011 aafigure-team

Redistribution and use in source and binary forms, with or without modification, are permitted under the terms of the BSD License.

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.