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.