< GeekHorse.com

--- Info -----------------------------------------------------------------------
What      : Pinto(TM) Image Format
Version   : 1.0.02
Author    : Jeremiah Martell
Copyright : (C) 2012-2014
License   : 3-clause BSD
Download  : pinto-1.0.02.tar.gz (93 KiB)
Clone     : git://github.com/GeekHorse/Pinto.git
View      : https://github.com/GeekHorse/Pinto

--- Description ----------------------------------------------------------------
Pinto is a small image format that only uses printable ASCII characters in it's
If you don't need the encoding to be text, the image can be made even smaller by
running it through a standard compression program like gzip.

It can compress images down to less than 15% of PNG.

It supports encoding images:
- 4096x4096 or smaller
- 63 colors or less
- With fully transparent or fully opaque pixels. No partial transparency.

Types of images it IS good at encoding are:
- "Pen and paper" drawings.
- Diagrams and graphs.
- Old school video game sprites.
- Icons.
- Bitmap fonts.
- Pixel Art.

Types of images it IS NOT good at encoding are:
- Photographs.
- Anti-aliased images.
- Images with gradients.

Despite not encoding anti-aliased images well, it can create anti-aliased
images by downsizing an image to half-size. The double-size Pinto image can
still be smaller than a half-size PNG. See /examples/antialiased,
pintoImageDownsize() and the rgbaDownsize option in the utility pintoToRgba.

Since the encoding uses only printable 7-bit ascii characters, it can be
embedded in a plain text file, or a UTF-8 text file. The format doesn't use
backslashes or double quotes, so it can also be embedded in source code as a

char *heart =

You may add newline characters in the middle of the format, in case you want the
format to span multiple lines.

It achieves small sizes by:
- Limiting the number of colors to 63.
- Limiting transparency to either fully opaque or fully transparent.
- Using a reduced color depth of 18 bits per pixel.
- Using Run-length encoding (RLE).
- Using the Painter's algorithm.
- Using a simplified version of the Deflate algorithm.

The only new idea (at least new to me) is to mix RLE with the Painter's
Algorithm. Each color is RLE encoded individually, and latter colors can paint
over previous colors. This allows the previous runs to be longer, which means
they can be encoded smaller.

The library itself is also small, only around 17KB.

Pinto comes with some utilities that can, with ImageMagick, convert images to
and from the Pinto format.

Pinto is finished. Only bugfixes will be added should they be needed.

--- Quality --------------------------------------------------------------------
- Compiled with gcc's -Wall -Werror and -Wextra.
  Compiles with 0 warnings.
- Many unit tests guarantee everything works correctly.
- gcov and lcov is used to make sure we get as much coverage as possible.
  Current coverage is 100% branch coverage.
- Valgrind is used to look for memory leaks and memory corruption.
  There are 0 memory leaks or errors reported.
- Compiles cleanly against C89, C99, and C11 standards.
- All code is documented with doxygen comments.
- All functions are reentrant.
- Contains no third-party code, written entirely by Jeremiah.

Copyright © 2013-2014 Jeremiah Martell