NAME

     ansilove — ANSI / ASCII art to PNG converter

SYNOPSIS

     ansilove [-dhiqrsSv] [-b bits] [-c columns] [-f font] [-m mode] [-o file] [-R factor]
              [-t type] file

DESCRIPTION

     ansilove is an ANSI / ASCII art to PNG converter, allowing to convert ANSI and artscene-
     related file formats into PNG images, supporting ANSI (.ANS), PCBoard (.PCB), Binary (.BIN),
     Artworx (.ADF), iCE Draw (.IDF), Tundra (.TND) and XBin (.XB) formats.

     It creates size optimized 4-bit PNG files and supports SAUCE (Standard Architecture for
     Universal Comment Extensions), 80x25 and 80x50 PC fonts (including all the 14 MS-DOS
     charsets), Amiga fonts, and iCE colors.

     The options are as follows:

     -b bits     Set to 9 to render 9th column of block characters (default: 8).

     -c columns  Adjust number of columns for ANSI, BIN, and TND files.

     -d          Enable DOS aspect ratio.

     -f font     Select font for supported formats.

                 Valid options for PC fonts are:

                 80x25              Default (Code page 437)

                 80x50              80x50 mode (Code page 437)

                 cp737              Greek (Code page 737)

                 cp775              Baltic (Code page 775)

                 cp850              Latin1 (Code page 850)

                 cp852              Latin2 (Code page 852)

                 cp855              Cyrillic (Code page 855)

                 cp857              Turkish (Code page 857)

                 cp860              Portuguese (Code page 860)

                 cp861              Icelandic (Code page 861)

                 cp862              Hebrew (Code page 862)

                 cp863              French Canadian (Code page 863)

                 cp865              Nordic (Code page 865)

                 cp866              Russian (Code page 866)

                 cp869              Greek (Code page 869)

                 terminus           Terminus (Modern font, code page 437)

                 Valid options for Amiga fonts are:

                 amiga              Alias to Topaz, see below

                 microknight        Original MicroKnight version

                 microknight+       Modified MicroKnight version

                 mosoul             Original mO'sOul font

                 pot-noodle         Original P0T-NOoDLE font

                 topaz              Original Topaz Kickstart 2.x version

                 topaz+             Modified Topaz Kickstart 2.x+ version

                 topaz500           Original Topaz Kickstart 1.x version

                 topaz500+          Modified Topaz Kickstart 1.x version

     -h          Show help.

     -i          Enable iCE colors.

     -m mode     Set rendering mode for ANS files.

                 Valid options are:

                 ced     Black on gray, with 78 columns.

                 transparent
                         Render with transparent background.

                 workbench
                         Use Amiga Workbench palette.

     -o file     Specify output filename/path.

     -q          Suppress output messages (quiet).

     -r          Create Retina @2x output file.

     -R factor   Create Retina output file with custom scale factor.

     -t type     Specify input file type.

                 Valid types are:

                 ans     ANSi (ANSI escape sequences: ANSI X3.64 standard)

                 adf     Artworx format, supporting custom character sets and palettes

                 bin     Binary format (raw memory copy of text mode video memory)

                 idf     iCE Draw format, supporting custom character sets and palettes

                 pcb     PCBoard Bulletin Board System (BBS) own file format

                 tnd     TundraDraw format, supporting 24-bit color mode

                 xb      XBin format, supporting custom character sets and palettes

     -s          Show SAUCE record without generating output.

     -S          If available, use SAUCE info for render options (ex: width).

     -v          Show version information.

EXAMPLES

     To render a file with iCE colors enabled:

           $ ansilove -i file.ans

     To create a Retina @2x output file:

           $ ansilove -r file.ans

     To creates a Retina output file with a custom scale factor:

           $ ansilove -R 3 file.ans

     To only display SAUCE record without generating output:

           $ ansilove -s file.ans
     To render a file with transparent background:

           $ ansilove -m transparent file.ans

     To render a file using a custom font:

           $ ansilove -f amiga file.txt

     To render a file using a custom font, rendering the 9th column, enabling iCE colors, and
     using DOS aspect ratio:

           $ ansilove -f 80x50 -b 9 -d -i file.ans

AUTHORS

     ansilove was written by Stefan Vogt, Brian Cassidy, and Frederic Cambus.