nuclear@14: libimago
nuclear@14: ========
nuclear@14: 
nuclear@14: Overview
nuclear@14: --------
nuclear@14: Imago is a simple C library for reading and writing images in many different
nuclear@14: image file formats.
nuclear@14: 
nuclear@14: Download
nuclear@14: --------
nuclear@14: Latest release: http://nuclear.mutantstargoat.com/sw/libimago/files/libimago-2.0.tar.gz
nuclear@14: 
nuclear@14: Grab the source code from github: https://github.com/jtsiomb/libimago
nuclear@14: 
nuclear@14: web site: http://nuclear.mutantstargoat.com/sw/libimago
nuclear@14: 
nuclear@14: License
nuclear@14: -------
nuclear@14: 
nuclear@14: Copyright (C) 2011-2015 John Tsiombikas <nuclear@member.fsf.org>
nuclear@14: 
nuclear@14: You may freely use, modify and/or redistribute libimago, under the terms of the
nuclear@14: GNU Lesser General Public License (LGPL) version 3 (or at your option, any
nuclear@14: later version published by the Free Software Foundation). See COPYING_ and
nuclear@14: COPYING.LESSER_ for details.
nuclear@14: 
nuclear@14: Usage example
nuclear@14: -------------
nuclear@14: 
nuclear@14: heck out the example program under ``test/``, and the *heavily*
nuclear@14: commented ``imago2.h`` header file, to find out how to use libimago.
nuclear@14: 
nuclear@14: The simplest way to load image data in RGBA 32bit is:
nuclear@14: 
nuclear@14: .. code:: c
nuclear@14: 
nuclear@14:  int width, height;
nuclear@14:  unsigned char *pixels = img_load_pixels("foo.png", &width, &height, IMG_FMT_RGBA32);
nuclear@14:  img_free_pixels(pixels);
nuclear@14: 
nuclear@14: There's also an optional interface for loading an image and creating an OpenGL
nuclear@14: texture out of it in a single call:
nuclear@14: 
nuclear@14: .. code:: c
nuclear@14: 
nuclear@14:  unsigned int texture = img_gltexture_load("foo.png");
nuclear@14: 
nuclear@14: .. _COPYING: http://www.gnu.org/licenses/gpl
nuclear@14: .. _COPYING.LESSER: http://www.gnu.org/licenses/lgpl