img_codec_list_byext()

Перечисление кодеков по расширению файла

Прототип:

#include <img.h>
size_t img_codec_list_byext( img_lib_t ilib,
const char *string,
img_codec_t *buf,
size_t nbuf );

Аргументы:

ilib
Дескриптор библиотеки, заполенный img_lib_attach().
string
Строка, содержащая расширение файла для идентификации. Например, jpg, для файлов с именем filename.jpg.
buf
Адрес массива, который функция заполняет дескрипторами для доступных кодеков.
nbuf
Количество элементов в массиве buf.

Библиотека:

img

Описание:

Функция перечисляет кодеки, обрабатывающие файлы с указанным расширением.

Не существует стандартов по определению расширений и их названий. Однако, есть стандарт де-факто, регулирующий применение расширений. Термин “расширение” происходит от внутренних свойств имени файла, хотя в большинстве современных реализций расширения не рассматриваются как отдельные компоненты имени файла. Таким образом, элемент “расширение” развивался, чтобы по части символов в имени файла, следующих да последним появлением символа “.”, можно было дать его приближенное описание. Такой же принцип встречается в сети Интернет и во многих операционных системах, в которых используют расширения в качестве механизма распознавания контента. Хотя расширения не гарантируют, каким будет характер данных, содержащихся в файле, но назначаются они из хорошо известного набора и не могут в точности отразить критериев по принятию решений в применении того или иного кодека обработки данных, по крайнем мере на начальном этапе.

В массив buf копируется не более чем nbuf дескрипторов. Копирование не произвоится, если nbuf равно 0. Функция возвращает общее количество подходящих кодеков, которое может быть больше, чем nbuf, если буфер не был достаточно большим для хранения всех дескрипторов.

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

Общее количество подходящих кодеков.

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

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

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

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

img_codec_list(), img_codec_list_bymime(), img_lib_attach()




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