ANSILOVE(1) User Commands ANSILOVE(1)

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.

illumos August 28, 2020 illumos