1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/libs/imago/README.rst	Sun Jun 07 17:25:49 2015 +0300
     1.3 @@ -0,0 +1,49 @@
     1.4 +libimago
     1.5 +========
     1.6 +
     1.7 +Overview
     1.8 +--------
     1.9 +Imago is a simple C library for reading and writing images in many different
    1.10 +image file formats.
    1.11 +
    1.12 +Download
    1.13 +--------
    1.14 +Latest release: http://nuclear.mutantstargoat.com/sw/libimago/files/libimago-2.0.tar.gz
    1.15 +
    1.16 +Grab the source code from github: https://github.com/jtsiomb/libimago
    1.17 +
    1.18 +web site: http://nuclear.mutantstargoat.com/sw/libimago
    1.19 +
    1.20 +License
    1.21 +-------
    1.22 +
    1.23 +Copyright (C) 2011-2015 John Tsiombikas <nuclear@member.fsf.org>
    1.24 +
    1.25 +You may freely use, modify and/or redistribute libimago, under the terms of the
    1.26 +GNU Lesser General Public License (LGPL) version 3 (or at your option, any
    1.27 +later version published by the Free Software Foundation). See COPYING_ and
    1.28 +COPYING.LESSER_ for details.
    1.29 +
    1.30 +Usage example
    1.31 +-------------
    1.32 +
    1.33 +heck out the example program under ``test/``, and the *heavily*
    1.34 +commented ``imago2.h`` header file, to find out how to use libimago.
    1.35 +
    1.36 +The simplest way to load image data in RGBA 32bit is:
    1.37 +
    1.38 +.. code:: c
    1.39 +
    1.40 + int width, height;
    1.41 + unsigned char *pixels = img_load_pixels("foo.png", &width, &height, IMG_FMT_RGBA32);
    1.42 + img_free_pixels(pixels);
    1.43 +
    1.44 +There's also an optional interface for loading an image and creating an OpenGL
    1.45 +texture out of it in a single call:
    1.46 +
    1.47 +.. code:: c
    1.48 +
    1.49 + unsigned int texture = img_gltexture_load("foo.png");
    1.50 +
    1.51 +.. _COPYING: http://www.gnu.org/licenses/gpl
    1.52 +.. _COPYING.LESSER: http://www.gnu.org/licenses/lgpl