img_write_file()

Кодирование кадра с сохранением в файл

Прототип:

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

Аргументы:

ilib: Дескриптор библиотеки, заполенный img_lib_attach().
path: Полный путь к создаваемому файлу.
callouts: Указатель на структуру img_encode_callouts_t, перенаправляющую системные колбэки кодировщику. При передаче значения NULL, библиотекой применяются колбэки по умолчанию.
img: Адрес структуры img_t, описывающей кодируемый кадр.

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

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

IMG_ERR_OK: Успешное завершение.
IMG_ERR_FILE: Ошибка пути доступа (устанавливается errno)
IMG_ERR_MEM: Ошибка выделения памяти.
IMG_ERR_FORMAT: Не удалось найти подходящий кодек для обрабатки расширения, включенного в указанное имя файла. Требуемый кодек может отсутствовать или поврежден.
IMG_ERR_NOSUPPORT: Формат входных данных не поддерживается; кодеку и приложению не удалось согласовать формат выходных данных.
IMG_ERR_TRUNC: Ошибка записи данных; файл был усечен.
IMG_ERR_INTR: Кодирование было прервано приложением.

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

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

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

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

img_encode_callouts_t, img_t, img_lib_attach()

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