# 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