img_load_resize_file()

Декодирование и изменение размера кадра из файла в файловой системе

Прототип:

#include <img.h>
                                       
int img_load_resize_file( img_lib_t ilib,
                          const char *path,
                          const img_decode_callouts_t *callouts,
                          img_t *img );

Аргументы:

ilib
Дескриптор библиотеки, заполенный img_lib_attach().
path
Полный путь к файлу, из которого можно производить чтение данных.
callouts
Не поддерживается; следует устанавливать NULL.
img
Адрес структуры img_t, которая заполняет функцию информацией о декодируемом кадре. Если до вызова функции задать ширину и высоту изображения (img.w и img.h), тогда размер изображения будт изменен в соответствии с указанными параметрами как при применении img_load_file(). Изменение размера выполняется "на лету" во время декодирования: без потери памяти при загрузке исходного изображения с последующим изменением его размера. Если укажзан только один из размеров, другой будет рассчитан на основе соотношения сторон исходного изображения.

Note: Необходимо установить соответствующий флаг измерения в структуре img. Например, при задании ширины необходимо установить флаг IMG_W.

Библиотека:

img

Описание:

Функция производит декодирование кадра из файла в файловой системе (первого встретившегося кадра), изменяя его размер, если указаны ширина и высота изображения.

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

IMG_ERR_OK
Успешное завершение.
IMG_ERR_CORRUPT
В файле обнаружены недопустимые данные, препятствующие продолжению декодирования. Часть кадра может быть неповрежденной.
IMG_ERR_DLL
Произошла ошибка при обработке DLL, обрабатывающей этот тип файла. Убедитесь, что DLL отсутствует или повреждена.
IMG_ERR_FILE
Ошибка доступа к пути (установлен errno).
IMG_ERR_FORMAT
Не удалось найти подходящий кодек. Требуемый кодек отсутствует или поврежден, либо файл поврежден.
IMG_ERR_INTR
Декодирование было прервано приложением.
IMG_ERR_MEM
Ошибка выделения памяти.
IMG_ERR_NODATA
Отсутствуют данные о кадре. Ошибка является маловероятной, т.к. файлы обычно содержат хотя бы один кадр.
IMG_ERR_NOSUPPORT
Формат входных данных не поддерживается; кодеку и приложению не удалось согласовать формат выходных данных.
IMG_ERR_TRUNC
Размер обрабатываемого файла меньше одидаемого. Часть кадра может быть неповрежденной.

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

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

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

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

img_decode_callouts_t, img_load_file(), img_load(), img_t, img_lib_attach()




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