MO_UnpackFrameImage

C Specification

#include <nitro/mobiclip.h>

u32 MO_UnpackFrameImage ( MOHandle handle );

Description

Unpack a frame and put it into internal image FIFO.

Mobiclip stores unpacked frames into an internal FIFO.
Each time MO_UnpackFrameImage is called, the new unpacked image is added to the FIFO.
Each time MO_BlitFrameImage or MO_SkipFrameImage function is called, the oldest unpacked image is removed from the FIFO (after being blitted or skipped).

You can call MO_UnpackFrameImage nbBufferedFrameMax times (see MO_OpenMovie) without the need to call MO_BlitFrameImage or MO_SkipFrameImage.
This is a useful feature which allows to do frame buffering.
At some point in the movie playback, calling MO_UnpackFrameImage can be a time consuming operation which can cause sound buffer underflow.
Prebuffering images allow to smooth occasional CPU peaks, thus preventing sound buffer underflow.

Arguments

handle Valid handle movie.

Return Values

1 if no error, 0 if error (no free internal buffer available) or if the handle is MO_INVALID_HANDLE.

See Also

MO_ReadFrame
MO_BlitFrameImage
MO_SkipFrameImage

Revision History

03/03/2008 Initial Version