Декодирование и изменение размера кадра из файла в файловой системе
#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(). Изменение размера выполняется "на лету" во время декодирования: без потери памяти при загрузке исходного изображения с последующим изменением его размера. Если укажзан только один из размеров, другой будет рассчитан на основе соотношения сторон исходного изображения.
 | Необходимо установить соответствующий флаг измерения в структуре 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