Skip to content

ansilove/libansilove

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

libansilove

libansilove is a library to convert ANSi and artscene related file formats into PNG images.

Dependencies

libansilove uses the CMake build system and requires the GD library and header files.

Installing dependencies

  • OpenBSD: pkg_add -r cmake gd
  • NetBSD: pkgin install cmake gd
  • FreeBSD: pkg install cmake gd
  • macOS: brew install cmake gd
  • Alpine Linux: apk add cmake gcc make musl-dev gd-dev
  • Debian / Ubuntu / Mint: apt-get install build-essential cmake libgd-dev
  • Fedora: dnf install cmake gcc make gd-devel
  • Solus: eopkg install -c system.devel and eopkg install gd-devel

Compiling

mkdir build
cd build
cmake ..
make

Installation

make install

Packages

libansilove packages are available for:

Features

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

Documentation

Usage

See the example directory for an example showing how to use the library to convert a file to PNG.

Projects using libansilove

  • Ansilove - ASCII / ANSI art to PNG converter, also supporting several artscene file formats
  • ANSi View (PS3) - ANSi and artscene related file formats viewer for the PlayStation 3

Bindings

Bindings for other programming languages:

License

libansilove is released under the BSD 2-Clause license. See the file LICENSE for details.

Authors

libansilove is developed by Stefan Vogt (@ByteProject), Brian Cassidy (@bricas) and Frederic Cambus (@fcambus).

Resources

Project homepage: https://www.ansilove.org

GitHub: https://github.com/ansilove/libansilove