img_lib_attach()

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

Прототип:

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

Аргументы:

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

Библиотека:

img

Описание:

Функция инициализирует библиотеку изображений, находит файл конфигурации /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


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

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

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

Файлы:

/etc/system/config/img.conf
Конфигурационный файл библиотеки работы с изображениями. Путь используется по умолчанию.

Переменные окружения:

LIBIMG_CFGFILE
Полный путь поиска файла конфигурации.

Классификация:

Графическая подсистема ЗОСРВ «Нейтрино», Библиотека Image

Обработчик прерываний
Нет
Обработчик сигналов
Нет
В потоке
Нет

Тематические ссылки:

img_cfg_read(), img_lib_detach()




Предыдущий раздел: Image API