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.

Debian                                           August 28, 2020                                     ANSILOVE(1)