_______ ___________ ___
__\___ \_ ____/ /\ /______ ___\_/__ /\
/ \| \/ _ \ /--\_____ \\ / /\ / \
_/ | / \ \ |/ / \ \ _ _____/ \_______
\ |_____\____/ / / \____ /\/ /
\______| \ \_____/\______ /\ \/ \ /\NSILOVE / C /____ _
\ |_______\__\___ \ \ \ / \___\__/____
\____| /____/\_\/\__ / / __/___ \ /\ ____
\ \ \ / /_/ __ \/ /__\__/ _/ _____ ___
/\ \____\/ / // \ / / / _>/ //__/\
/ \ _/ \ // / / / \/ / \__\/
_ _________ / \_______ _ \___ /_______/ / _/ \____ \ /
\ / \ \___/\ \_______/\\ \ \______/\/
\/ \_\ \ \_______\ \ \\/ \__\ \ \
\__\/ \______\/ h7/dS!\_____\/
AnsiLove is an ANSI and 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.
This is a complete rewrite of AnsiLove/PHP in the C programming language.
Experimental seccomp support is available for selected architectures and
can be enabled by setting the ENABLE_SECCOMP variable to 1 when
invoking CMake.
AnsiLove/C is strictly using the C99 standard to achieve high
portability to all major operating systems. Supported compilers are
GCC and Clang, others may work but aren't tested. We use Linux
and OpenBSD for AnsiLove/C development.
There were many reasons, most notably PHP interpreter independence and performance. A solid C foundation is just perfect for creating libraries and it can easily be embedded into applications. We already mentioned portability. What else? We wanted evolution. AnsiLove/C should not be understood as a port. It takes many different approaches (like processing binary font dumps or generating @2x Retina images), it is overall improved and introduces new features. While results tend to be the same, the codebase does not have much in common with it's ancestor.
AnsiLove/C uses the CMake build system and requires the
libansilove library and header files.
- OpenBSD:
pkg_add -r cmake - NetBSD:
pkgin install cmake - FreeBSD:
pkg install cmake - macOS:
brew install cmake - Alpine Linux:
apk add cmake gcc make musl-dev - Debian / Ubuntu / Mint:
apt-get install build-essential cmake - Fedora:
dnf install cmake gcc make - Solus:
eopkg install -c system.devel
Binary packages for libansilove are available on OpenBSD, NetBSD,
FreeBSD, Debian, Ubuntu, and Solus.
On other systems, libansilove has to be installed manually.
mkdir build
cd build
cmake ..
make
Ansilove packages are available for:
The following formats are supported:
- .ANS - ANSi (ANSI escape sequences: ANSI X3.64 standard)
- .PCB - PCBoard Bulletin Board System (BBS) own file format
- .BIN - Binary format (raw memory copy of text mode video memory)
- .ADF - Artworx format, supporting custom character sets and palettes
- .IDF - iCE Draw format, supporting custom character sets and palettes
- .TND - TundraDraw format, supporting 24-bit color mode
- .XB - The eXtended Binary XBin format, supporting custom character sets and palettes
Files with custom suffix default to the ANSi renderer (e.g. ICE or CIA).
AnsiLove/C is capable of processing:
- SAUCE records
- DOS and Amiga fonts (embedded binary dump)
- iCE colors
Even more:
- Small output file size (4-bit PNG).
- Optionally generates proper Retina @2x (and up to @8x) PNG.
- You can use custom options for adjusting output results.
- Built-in support for rendering Amiga ASCII.
ansilove [-dhiqrsv] [-b bits] [-c columns] [-f font] [-m mode] [-o file]
[-R factor] [-t type] file
-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.
-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.
-s Show SAUCE record without generating output.
-S If available, use SAUCE info for render options (ex: width).
-v Show version information.
There are certain cases where you need to set options for proper rendering. However, this is occasionally. Results turn out well with the built-in defaults.
We dumped many fonts as binary data right into AnsiLove/C, so the most popular typefaces for rendering ANSi / ASCII art are available at your fingertips.
PC fonts can be (all case-sensitive):
80x25Default (Code page 437)80x5080x50 mode (Code page 437)cp737Greek (Code page 737)cp775Baltic (Code page 775)cp850Latin-1 (Code page 850)cp852Latin-2 (Code page 852)cp855Cyrillic (Code page 855)cp857Turkish (Code page 857)cp860Portuguese (Code page 860)cp861Icelandic (Code page 861)cp862Hebrew (Code page 862)cp863French Canadian (Code page 863)cp865Nordic (Code page 865)cp866Russian (Code page 866)cp869Greek (Code page 869)spleenSpleen (Modern font, code page 437)terminusTerminus (Modern font, code page 437)
AMIGA fonts can be (all case-sensitive):
amiga(alias to Topaz)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)
bits can be:
8(8-bit)9(9-bit)
Setting the bits to 9 will render the 9th column of block characters,
so the output will look like it is displayed in real textmode.
See the "Memory Map" section of the Monochrome Display Adapter notes for more information.
mode can be (all case-sensitive):
cedtransparentworkbench
Setting the mode to ced will cause the input file to be rendered
in black on gray, and limit the output to 78 columns (only available
for ANS files). Used together with an Amiga font, the output will
look like it is displayed on Amiga.
Setting the mode to workbench will cause the input file to be
rendered using Amiga Workbench colors (only available for ANS
files).
Settings the mode to transparent will produce output files with
transparent background (only available for ANS files).
iCE colors are disabled by default, and can be enabled by specifying
the -i option.
When an ANSi source was created using iCE colors, it was done with a special mode where the blinking was disabled, and you had 16 background colors available. Basically, you had the same choice for background colors as for foreground colors, that's iCE colors.
columns is only relevant for .ANS, .BIN, .PCB, and .TND files, and
is optional. In most cases conversion will work fine if you don't set
this flag, the default value is 160 for .BIN files and 80
otherwise.
It's fine to use AnsiLove/C as SAUCE reader without generating any
output, just set option -s for this purpose.
- 16colo.rs - ANSI/ASCII art archive
- Textfiles.com - Uses Ansilove for the ANSI Art Collection PNG previews
- Durdraw - ASCII, Unicode and ANSI art editor for UNIX-like systems
- emacs-ansilove - Display buffers as PNG images using ansilove inside GNU Emacs
AnsiLove/C is released under the BSD 2-Clause license. See the
LICENSE file for details.
AnsiLove/C is developed by Stefan Vogt (@ByteProject), Brian Cassidy (@bricas) and Frederic Cambus (@fcambus).
Project homepage: https://www.ansilove.org
GitHub: https://github.com/ansilove/ansilove