# MO_BlitFrameImage

## C Specification

  `#include <nitro/mobiclip.h>`
  `u32 MO_BlitFrameImage ( `MOHandle` handle, u16* outFrameBufferPtr, u32 outFrameBufferPitch, u32 qualityEnhancement );`

## Description

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.
  The higher the quality enhancement is, the higher the CPU requirements will be. See effectiveUsage sample for an example on how to use this feature.

`MO_Malloc` is called inside this function the first time a blit is performed with visual quality enhancement.

## Arguments

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.

## Return Values

1 if no error, 0 if error (blit not performed or allocation error) or if the handle is `MO_INVALID_HANDLE`.

## See Also

`MO_UnpackFrameImage`
`MO_SkipFrameImage`

## Revision History

03/03/2008 Initial Version