#include <nitro/mobiclip.h>u32 MO_UnpackFrameImage ( MOHandle handle );
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.
| handle | Valid handle movie. |
1 if no error, 0 if error (no free internal buffer available) or if the handle is MO_INVALID_HANDLE.
MO_ReadFrame
MO_BlitFrameImage
MO_SkipFrameImage
03/03/2008 Initial Version