**Библиотека изображений DevIL версии 1.7.8: руководство, примечания и краткое использование**

DevIL — это библиотека изображений с открытым исходным кодом, распространение которой осуществляется на условиях лицензии GNU LGPL. Более подробную информацию см. в файле COPYING.

DevIL предлагает простой способ реализации загрузки, обработки, фильтрации, преобразования, отображения и сохранения из различных форматов изображений в вашем собственном проекте.

**Где найти?**

DevIL можно найти по адресу http://openil.sourceforge.net.

**Как собрать и установить три библиотеки?**

Пользователи *nix должны прочитать README.unix.
Пользователи VisualC должны прочитать README.win.
Пользователи Cygwin должны прочитать README.cygwin.
Пользователи MacOSX должны прочитать README.macosx.
PS: *nix обозначает GNU/Linux, *BSD, SunOS/Solaris и, возможно, некоторые другие.

Более подробное руководство

Этот файл является лишь кратким руководством для получения более подробной информации о том, как использовать DevIL. Более подробное руководство в настоящее время можно найти на сайте DevIL по адресу http://openil.sf.net и в каталоге /Docs при обычной установке.

Почему ещё одна библиотека изображений?

Я никогда не видел библиотеку изображений, которая могла бы делать всё то, что умеет DevIL. Конечно, различные библиотеки могут выполнять часть того, что может делать DevIL, так же хорошо или даже лучше, но я хотел простую в использовании библиотеку, которая охватывала бы все эти функции. Я также хотел чрезвычайно портативную библиотеку изображений, которую можно было бы использовать с разных языков и которая использовала бы синтаксис OpenGL.

Основное руководство

Почти всё, что указано в этом документе, относится к DevIL, а также к DevILU и DevILUT, если не указано иное. (Этот файл лучше всего просматривать с включённой функцией переноса слов.)

Ошибки

Все ошибки, возникающие внутри DevIL, вместе с незаконными параметрами, переданными функциям DevIL, перехватываются и передаются в ilSetError(), внутреннюю функцию библиотеки. Вызывающая программа может вызвать ilGetError() для получения значения возникшей ошибки. Типы ошибок определены в il.h, используя диапазон 0x501–0x5FF. ilGetError() вернёт 0 (IL_NO_ERROR), если ошибка не произошла.

Базовое использование

Это демонстрирует загрузку изображения через DevIL для OpenGL. Не забудьте вызвать ilInit перед тем, как что-либо делать:

#include <IL/il.h>
#include <IL/ilu.h>
#include <IL/ilut.h>
...
ILuint devilError;

ilInit();
devilError = ilGetError();
if (devilError != IL_NO_ERROR) {
  printf ("Devil Error (ilInit: %s\n", iluGetErrorString (devilError));
  exit (2);
}
...
ILuint devilID;

ilGenImages(1, &devilID);
ilBindImage(devilID);
ilLoadImage("default1.tga"); // Загружает в текущее связанное изображение
devilError = ilGetError();

if (devilError != IL_NO_ERROR) {
  printf ("Devil Error (ilLoadImage: %s\n", iluGetErrorString (devilError));
  exit (2);
}
...
ilutRenderer(IL_OPENGL); // Переключает рендерер
...
GLuint openglID, openglError;
openglID = ilutGLBindTexImage(); // Это генерирует текстуру за вас
devilError = ilGetError();

if (devilError != IL_NO_ERROR) {
  printf ("Error: %s\n", iluGetErrorString (devilError));
  exit (2);
}

if (openglError != GL_NO_ERROR) {
  printf ("Opengl Error (ilutGLBindTexImage): %s\n", gluGetErrorString (openglError));
  exit (2);
}

// Обязательно закройте изображение, когда закончите с ним (хотя DevIL автоматически удаляет их при выходе из программы):
glDeleteTextures(1, &openglID);
ilDeleteImages (1, &devilID);

Дополнительные примеры

Проект TestIL включён для тестирования функций DevIL.

DevIL включает проект под названием GLTest. Это простая проверка возможностей DevIL. Всё, что он делает, это загружает любое изображение и отображает его в окне, созданном FreeGlut, который доступен по адресу http://freeglut.sourceforge.net. Он также включён, чтобы позволить пользователю... Есть представление о том, для чего действительно можно использовать библиотеку.

Есть несколько других тестовых проектов для проверки поддержки различных API отображения. Проект WindowsTest — это базовая программа для работы с изображениями, которая сейчас работает только в Windows, но демонстрирует некоторые функции DevIL через различные меню.

Если вам нужны более подробные руководства, вы можете найти их на сайте http://openil.sf.net или они могут быть в вашей установке в каталоге /examples. Документы также доступны в каталоге /docs.

Дополнительное чтение
------------------

Для всех форматов изображений, используемых в DevIL, есть соответствующие документы на сайте http://www.wotsit.org в разделе «Графические файлы». Эти документы оказались бесценными при создании этой библиотеки, когда ещё не было доступной библиотеки для этого формата изображения.

Юридические аспекты
-------------------

Всё содержимое этого файла является интеллектуальной собственностью Denton Woods, авторские права 2001–2008.