img_convert_getfunc()

Получение указателя на функцию преобразования одного формата изображения в другой

Прототип:

#include <img.h>
img_convert_f * img_convert_getfunc( img_format_t src,
img_format_t dst );

Аргументы:

src
Формат преобразовываемого изображения img_format_t
dst
Целевой формат изображения img_format_t

Библиотека:

img

Описание:

Данная функция возвращает указатель на функцию преобразования данных (или NULL если запрашиваемое преобразование не поддерживается), вызываемую для преобразования пикселей из формата src в dst. Исходный и целевой форматы не должны использовать палитру. Преобразующая функция имеет следующий прототип:

void convert_f( const uint8_t *src, uint8_t *dst, unsigned n );

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

Используйте функцию вместо img_convert_data() для многократного преобразования данных из одного формата в другой. Вызов img_convert_data() будет иметь излишние накладные расходы при каждом вызове, поскольку должен каждый раз получать указатель на функцию преобразования. При применении этой функции можно вызвать функцию преобразования явно.

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

IMG_ERR_OK
Успешное завершение.
IMG_ERR_NOSUPPORT
Один из указанных форматов недействителен.

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

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

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

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

img_convert_data(), IMG_FMT_BPL(), img_lib_attach()




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