img_codec_list()

Enumerate codecs

Synopsis:

#include <img.h>

size_t img_codec_list( img_lib_t    ilib,
                       img_codec_t* buf,
                       size_t       nbuf,
                       img_codec_t* exclude,
                       size_t       nexclude );

Arguments:

ilib

The handle for the image library, returned by img_lib_attach().

buf

The address of an array that the function populates with handles for available codecs.

nbuf

The number of items in the buf array.

exclude

The address of an array of codec handles that you'd like the function to exclude from the list.

nexclude

The number of items in the exclude array.

Library:

img

Description:

This function lists all codecs installed, except for those specified by exclude.

The function copies up to nbuf handles into the array specified by buf. No copying is done if nbuf is 0. This function returns the total number of matching codecs, which may be larger than nbuf if your buffer was not big enough to store all the matched codecs.

Returns:

The the total number of matching codecs.

Classification:

Image library

See also:

img_codec_list_byext(), img_codec_list_bymime(), img_lib_attach()