1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
|
# 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:
- [OpenBSD][1]
- [NetBSD][2]
- [FreeBSD][3]
- [Debian][4]
- [Ubuntu][5]
- [openSUSE][6]
- [Solus][7]
- [Gentoo][8]
- [Homebrew][9]
- [Guix][10]
# 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][11] - ASCII / ANSI art to PNG converter, also supporting several artscene file formats
- [ANSi View (PS3)][12] - ANSi and artscene related file formats viewer for the PlayStation 3
- [Abydos][13] - Image loading library which handles both raster and vector graphics
# Bindings
Bindings for other programming languages:
- [Racket][14]
# License
libansilove is released under the BSD 2-Clause license. See the file `LICENSE` for details.
# Authors
libansilove is developed by Stefan Vogt ([@ByteProject][15]), Brian Cassidy
([@bricas][16]) and Frederic Cambus ([@fcambus][17]).
# Resources
Project homepage: https://www.ansilove.org
GitHub: https://github.com/ansilove/libansilove
[1]: https://openports.pl/path/graphics/libansilove
[2]: https://pkgsrc.se/graphics/libansilove
[3]: https://www.freshports.org/graphics/libansilove/
[4]: https://packages.debian.org/search?keywords=libansilove
[5]: https://packages.ubuntu.com/search?keywords=libansilove
[6]: https://software.opensuse.org/package/libansilove
[7]: https://dev.getsol.us/source/libansilove/
[8]: https://packages.gentoo.org/packages/dev-libs/libansilove
[9]: https://formulae.brew.sh/formula/libansilove
[10]: https://packages.guix.gnu.org/packages/libansilove/
[11]: https://github.com/ansilove/ansilove
[12]: https://github.com/bucanero/ansiview-ps3
[13]: https://snisurset.net/code/abydos/
[14]: https://gitlab.com/xgqt/racket-libansilove
[15]: https://github.com/ByteProject
[16]: https://github.com/bricas
[17]: https://github.com/fcambus
|
