#include <nitro/mobiclip.h>u32 MO_BlitFrameImage ( MOHandle handle,
u16* outFrameBufferPtr, u32 outFrameBufferPitch, u32 qualityEnhancement );
Blit the oldest unpacked image from the internal FIFO into a user buffer and remove it from the FIFO.
The output is in NITRO Direct Color format(16 bits).
To avoid unnecessary copies, give a direct address to video memory in outFrameBufferPtr.
The qualityEnhancement parameter can have the following values:
MO_QUALITY_ENHANCEMENT_NONE: a simple color conversion is performed.MO_QUALITY_ENHANCEMENT_MEDIUM:MO_QUALITY_ENHANCEMENT_HIGH: apply a post-filtering before color conversion, used to reduce video compression artefacts.
MO_Malloc is called inside this function the first time a blit is performed with visual quality enhancement.
| handle | Valid handle movie |
| outFrameBufferPtr | Pointer where the image frame must be blitted |
| outFrameBufferPitch | Pitch (scanline) in pixels of the destination frame buffer | qualityEnhancement | The kind of visual quality enhancement wanted. |
1 if no error, 0 if error (blit not performed or allocation error) or if the handle is MO_INVALID_HANDLE.
MO_UnpackFrameImage
MO_SkipFrameImage
03/03/2008 Initial Version