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