ANSILOVE(1)

NAME
ansilove - ANSI / ASCII art to PNG converter

SYNOPSIS
ansilove [-ehirsv] [-b bits] [-c columns] [-f font] [-m mode] [-o file] [-R factor] 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 Extentions), 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 BIN files (default: 160)

-e  Print a list of examples

-f font
    Select font for supported formats.

    Valid options for PC fonts are:

    80x25
        Default (Code page 437)

    80x50
        80x50 mode (Code page 437)

    baltic
        Baltic (Code page 775)

    cyrillic
        Cyrillic (Code page 855)

    french-canadian
        French Canadian (code page 863)

    greek
        Greek (code page 737)

    greek-869
        Greek-869 (code page 869)

    hebrew
        Hebrew (code page 862)

    icelandic
        Icelandic (Code page 861)

    latin1
        Latin1 (code page 850)

    latin2
        Latin2 (code page 852)

    nordic
        Nordic (code page 865)

    portuguese
        Portuguese (Code page 860)

    russian
        Russian (code page 866)

    turkish
        Turkish (code page 857)

    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

-r  Creates additional Retina @2x output file

-R factor
    Creates additional Retina output file with custom scale factor

-s  Show SAUCE record without generating output

-v  Show version information

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