# MO_OpenMovie

## C Specification

  `#include <nitro/mobiclip.h>`
  `MOHandle` `MO_OpenMovie ( FSFile *file, u32 nbBufferedFrameMax );`

## Description

Open a Mobiclip movie from a file.
`MO_Malloc` is called inside this function.

## Arguments

file | Already opened NITRO file handle.
nbBufferedFrameMax | Maximum number of frames who can be successively unpacked without been blitted or skipped. `MO_NB_BUFFERED_FRAME_MIN` is the minimum value allowed.

## Return Values

Return a `MOHandle` value if ok, `MO_INVALID_HANDLE` if error.

Cause of error :

  - impossible to Read Mobiclip header.
  - incompatible file format (typically, this is not a valid Mobiclip movie).
  - wrong movie resolution (it must not exceed 256x192).
  - not enough memory (allocation error).
  - nbBufferedFrameMax value is below the minimum allowed

## See Also

`MO_CloseMovie`

## Revision History

03/03/2008 Initial Version