img_lib_attach()

Инициализация библиотеки изображений

Прототип:

#include <img.h>
                                       
int img_lib_attach( img_lib_t *ilib );

Аргументы:

ilib: Указатель для хранения дескриптора библиотеки.

Функция инициализирует библиотеку изображений, находит файл конфигурации /etc/system/config/img.conf и загружает перечисленные в нем кодеки. Если файл конфигурации не найден, функция заполняет дескриптор библиотеки, но не загружает кодеки, следовательно, изображение не может быть декодировано. В этом случае функция возвращает значение IMG_ERR_CFG. Кодеки можжно загрузить после инициализации библиотеки, вызвав img_cfg_read() .

Файл конфигурации

Библиотека изображений использует файл конфигурации, чтобы определить, какие кодеки загружать. Функция сначала проверяет переменную LIBIMG_CFGFILE, которая содержит полный путь поиска файла конфигурации. Если переменная не задана, то проверяется путь поиска по умолчанию: /etc/system/config/img.conf.

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

[img_codec_jpg.so]
mime=image/jpeg:image/jpg
ext=jpg:jpeg

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

Возвращаемое значение:

IMG_ERR_OK: Успешное завершение.
IMG_ERR_MEM: Ошибка выделения памяти.
IMG_ERR_CFG: Файл конфигурации некорректен или отсутствует. Возвращенный дескриптор действителен, но кодеки не загружены. Это может не являться проблемой, если Вы планируете использовать собственный кодек (загруженный с помощью img_codec_register() или img_codec_register_dll()), а не стандартные предзагружаемые.