img_decode_finish()

Release decode resources

Synopsis:

#include <img.h>

int img_decode_finish( img_codec_t     codec,
                       io_stream_t *   input,
                       uintptr_t *     decode_data );

Arguments:

codec
The handle of the codec that was used to decode.
input
A pointer to an input stream for the image data.
decode_data
The address of the uintptr_t that was used for img_decode_begin() and img_decode_frame().

Library:

img

Description:

This function finalizes the decode process and releases resources allocated during a decoding session. You should call this function after you have finished decoding a series of frames, to release any resources that the decoder may have allocated in association with those frames.


Note: You do not need to decode all the frames in a stream, but you should always follow up with img_decode_finish() when you have decoded the frames you are interested in to avoid potential memory leaks.

Returns:

IMG_ERR_OK
Success.
IMG_ERR_NOTIMPL
The codec doesn't support decoding (Currently, all codecs shipped with the Neutrino image library support decoding).
Other
Any other code that a decoder's begin() function may pass back to flag an error (see img_errno.h for a list of defined errors).

Classification:

Image library

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

img_decode_begin(), img_decode_frame()