3dphotoshoot
annotate libs/imago/README.rst @ 14:06dc8b9b4f89
added libimago, libjpeg and libpng
| author | John Tsiombikas <nuclear@member.fsf.org> |
|---|---|
| date | Sun, 07 Jun 2015 17:25:49 +0300 |
| parents | |
| children |
| rev | line source |
|---|---|
| nuclear@14 | 1 libimago |
| nuclear@14 | 2 ======== |
| nuclear@14 | 3 |
| nuclear@14 | 4 Overview |
| nuclear@14 | 5 -------- |
| nuclear@14 | 6 Imago is a simple C library for reading and writing images in many different |
| nuclear@14 | 7 image file formats. |
| nuclear@14 | 8 |
| nuclear@14 | 9 Download |
| nuclear@14 | 10 -------- |
| nuclear@14 | 11 Latest release: http://nuclear.mutantstargoat.com/sw/libimago/files/libimago-2.0.tar.gz |
| nuclear@14 | 12 |
| nuclear@14 | 13 Grab the source code from github: https://github.com/jtsiomb/libimago |
| nuclear@14 | 14 |
| nuclear@14 | 15 web site: http://nuclear.mutantstargoat.com/sw/libimago |
| nuclear@14 | 16 |
| nuclear@14 | 17 License |
| nuclear@14 | 18 ------- |
| nuclear@14 | 19 |
| nuclear@14 | 20 Copyright (C) 2011-2015 John Tsiombikas <nuclear@member.fsf.org> |
| nuclear@14 | 21 |
| nuclear@14 | 22 You may freely use, modify and/or redistribute libimago, under the terms of the |
| nuclear@14 | 23 GNU Lesser General Public License (LGPL) version 3 (or at your option, any |
| nuclear@14 | 24 later version published by the Free Software Foundation). See COPYING_ and |
| nuclear@14 | 25 COPYING.LESSER_ for details. |
| nuclear@14 | 26 |
| nuclear@14 | 27 Usage example |
| nuclear@14 | 28 ------------- |
| nuclear@14 | 29 |
| nuclear@14 | 30 heck out the example program under ``test/``, and the *heavily* |
| nuclear@14 | 31 commented ``imago2.h`` header file, to find out how to use libimago. |
| nuclear@14 | 32 |
| nuclear@14 | 33 The simplest way to load image data in RGBA 32bit is: |
| nuclear@14 | 34 |
| nuclear@14 | 35 .. code:: c |
| nuclear@14 | 36 |
| nuclear@14 | 37 int width, height; |
| nuclear@14 | 38 unsigned char *pixels = img_load_pixels("foo.png", &width, &height, IMG_FMT_RGBA32); |
| nuclear@14 | 39 img_free_pixels(pixels); |
| nuclear@14 | 40 |
| nuclear@14 | 41 There's also an optional interface for loading an image and creating an OpenGL |
| nuclear@14 | 42 texture out of it in a single call: |
| nuclear@14 | 43 |
| nuclear@14 | 44 .. code:: c |
| nuclear@14 | 45 |
| nuclear@14 | 46 unsigned int texture = img_gltexture_load("foo.png"); |
| nuclear@14 | 47 |
| nuclear@14 | 48 .. _COPYING: http://www.gnu.org/licenses/gpl |
| nuclear@14 | 49 .. _COPYING.LESSER: http://www.gnu.org/licenses/lgpl |