summaryrefslogtreecommitdiff
path: root/README
blob: 89123a5cc7e8d2462df0af221f622395512475b7 (plain)
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

                     ███ ███ ██  ██  ███ ███ █   ██
                     █   █ █ █ █ █ █ █   █   █   █ █
                     ██  ███ ███ ███ ██  ██  █   █ █
                     █   █ █ █ █ █ █ █   █   █   █ █
                     █   █ █ █ █ ██  █   ███ ███ ██


WHAT IS FARBFELD?
	Farbfeld is a lossless image-format designed to be
	parsed and piped easily.
	It can be compressed easily and beats PNG's filesize
	in many cases.

WHY FARBFELD?
	Current image-formats have integrated compression,
	making it complicated to read the image data.
	One is forced to use complex libraries like libpng,
	libjpeg, libjpeg-turbo, giflib and others, read the
	documentation and write a lot of boilerplate in order
	to get started.
	Farbfeld leaves this behind and is designed to be as
	simple as possible, leaving the task of compression
	to outside tools.
	The simple design, which was the primary objective,
	implicitly lead to the very good compression
	characteristics, as it often happens when you go with
	the UNIX philosophy.
	Reading farbfeld images doesn't require any special
	libraries. The tools in this folder are just a toolbox
	to make it easy to convert between common image formats
	and farbfeld.

HOW DOES IT WORK?
	In Farbfeld, pattern resolution is not done while
	converting, but while compressing the image.
	For example, farbfeld always stores the alpha-channel,
	even if the image doesn't have alpha-variation.
	This may sound like a big waste at first, but as
	soon as you compress an image of this kind, the
	compression-algorithm (e.g. bz2) recognizes the
	pattern that every 48 bits the 16 bits store the
	same information.
	And the compression-algorithms get better and better
	at this.
	Same applies to the idea of having 16 bits per channel.
	It sounds excessive, but if you for instance only have
	a greyscale image, the R, G and B channels will store
	the same value, which is recognized by the compression
	algorithm easily.
	This effectively leads to filesizes you'd normally only
	reach with paletted images, and in some cases bz2 even
	beats png's compression, for instance when you're dealing
	with grayscale data, line drawings, decals and even
	photographs.

HOW DO I USE THE TOOLS?
	encoding:
	png2ff < example.png > example.ff
	png2ff < example.png | bzip2 > example.ff.bz2

	decoding:
	ff2png < example.ff > example.png
	bzcat example.ff.bz2 | ff2png > example.png

	bz2 is recommended for compression, but you can use
	any algorithm you want.