img_dtransform_create()

Подготавливает изображение к преобразованию

Прототип:

#include <img.h>
int img_dtransform_create( const img_t *src,
const img_t *dst,
img_dtransform_t *xform );

Аргументы:

src
Формат исходного изображения
dst
Выходной формат изображения
xform
Переадресация структуры формата img_dtransform_t, где функция будет хранить созданное преобразование.

Библиотека:

img

Описание:

Функция подготавливает изображение к преобразованию из одного формата src в другой dst. После данной функции необходимо вызвать img_dtransform_apply() для применения преобразования, а затем img_dtransform_free(), чтобы освободить структуру xform.


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

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

IMG_ERR_OK
Успешное завершение. Переменная xform является действительным и должна быть освобождено по завершению преобразования. В противном случае возвращается код ошибки, а переменная xform не является действительным и не должна быть особождена в будущем.
IMG_ERR_PARM
Обязательные биты флагов для src не установлены (как минимум должны быть установлены IMG_H и IMG_W).
IMG_ERR_MEM
Недостаточно памяти для преобразования.
IMG_ERR_NOSUPPORT
Запрошиваемое преобразование не поддерживается.

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

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

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

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

img_t, img_dtransform_t, img_dtransform_apply(), img_dtransform_free()




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