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