img_decode_finish()

Release decode resources

Synopsis:

#include <img/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:

libimg

Use the -l img option to qcc to link against this library.

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 provide an implementation for this function.
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