# MO_OpenMovie

## 構文

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

## 説明

ファイルからMobiclipムービーを開きます。
`MO_Malloc` はこの関数内で呼び出されます。

## 引数

file | 既に開かれているnitroファイルのハンドル。
nbBufferedFrameMax | blit転送やスキップなしで問題なく解凍できるフレームの最大数。 値を `MO_NB_BUFFERED_FRAME_MIN` 以下にすることはできません。

## 返り値

成功の場合は `MOHandle` 値、エラーの場合は `MO_INVALID_HANDLE` を返します。

エラーの原因：

  - Mobiclip ヘッダが読み込めない
  - ファイルフォーマットに互換性がない（有効なMobiclipムービーでない場合が典型的です）
  - 誤ったムービー解像度（256x192を超えてはいけません）
  - メモリが足りない（割り当てエラー）
  - nbBufferedFrameMax の値が許容する最低限の値より低い

## 参照

`MO_CloseMovie`

## 履歴

2008/03/03 初版