YUV overlay operations
[General DC operations]

Data Structures

• struct _GAL_Overlay

Defines

• #define LockYUVOverlay   GAL_LockYUVOverlay

  Is an alias of GAL_LockYUVOverlay.
  

• #define UnlockYUVOverlay   GAL_UnlockYUVOverlay

  Is an alias of GAL_UnlockYUVOverlay.
  

• #define FreeYUVOverlay   GAL_FreeYUVOverlay

  Is an alias of GAL_FreeYUVOverlay.
  

Typedefs

• typedef _GAL_Overlay GAL_Overlay

Functions

• MG_EXPORT GAL_Overlay *GUIAPI CreateYUVOverlay (int width, int height, Uint32 format, HDC hdc)

  Creates a video output overlay on a DC.
  

• int GAL_LockYUVOverlay (GAL_Overlay *overlay)

  Locks an overlay for direct access.
  

• void GAL_UnlockYUVOverlay (GAL_Overlay *overlay)

  Unlocks a locked overlay when you are done.
  

• void GAL_FreeYUVOverlay (GAL_Overlay *overlay)

  Frees a YUV overlay.
  

• MG_EXPORT void GUIAPI DisplayYUVOverlay (GAL_Overlay *overlay, const RECT *dstrect)

  Blits a video overlay to the screen.
  

---

Detailed Description

For an explanation of common video overlay formats, see:

http://www.webartz.com/fourcc/indexyuv.htm

For information on the relationship between color spaces, see:

http://www.neuro.sfc.keio.ac.jp/~aly/polygon/info/color-space-faq.html

---

Define Documentation

#define FreeYUVOverlay   GAL_FreeYUVOverlay

Is an alias of GAL_FreeYUVOverlay. See also: GAL_FreeYUVOverlay Definition at line 1724 of file gdi.h.

#define LockYUVOverlay   GAL_LockYUVOverlay

Is an alias of GAL_LockYUVOverlay. See also: GAL_LockYUVOverlay Definition at line 1696 of file gdi.h.

#define UnlockYUVOverlay   GAL_UnlockYUVOverlay

Is an alias of GAL_UnlockYUVOverlay. See also: GAL_UnlockYUVOverlay Definition at line 1703 of file gdi.h.

---

Typedef Documentation

typedef struct _GAL_Overlay GAL_Overlay

The YUV hardware video overlay

---

Function Documentation

GAL_Overlay *GUIAPI CreateYUVOverlay (  int  width, int  height, Uint32  format, HDC  hdc )

Creates a video output overlay on a DC. This function creates a video output overlay on the given DC hdc. Calling the returned surface an overlay is something of a misnomer because the contents of the display DC hdc underneath the area where the overlay is shown is undefined - it may be overwritten with the converted YUV data. Parameters: width  The expected width of the video overlay. height  The expected height of the video overlay. format  The expected video overlay format, can be one of the following values: GAL_YV12_OVERLAY Planar mode: Y + V + U (3 planes) GAL_IYUV_OVERLAY Planar mode: Y + U + V (3 planes) GAL_YUY2_OVERLAY Packed mode: Y0+U0+Y1+V0 (1 plane) GAL_UYVY_OVERLAY Packed mode: U0+Y0+V0+Y1 (1 plane) GAL_YVYU_OVERLAY Packed mode: Y0+V0+Y1+U0 (1 plane) Parameters: hdc  The device context. Returns: A GAL_Overlay object on success, NULL on error. Note: Only defined for _USE_NEWGAL. See also: GAL_LockYUVOverlay, GAL_FreeYUVOverlay, http://www.webartz.com/fourcc/indexyuv.htm

void GUIAPI DisplayYUVOverlay (  GAL_Overlay *  overlay, const RECT *  dstrect )

Blits a video overlay to the screen. Calling this function will blit the video overly overlay to the screen. The contents of the video surface underneath the blit destination are not defined. The width and height of the destination rectangle may be different from that of the overlay, but currently only 2x scaling is supported. And note that the dstrect is in screen coordinate system. Parameters: overlay  The video overlay to be displayed. dstrect  The destination rectangle. It may be different from that of the overlay, but currently only 2x scaling is supported Note: Only defined for _USE_NEWGAL. See also: GAL_CreateYUVOverlay, GAL_LockYUVOverlay

void GAL_FreeYUVOverlay (  GAL_Overlay *  overlay  )

Frees a YUV overlay. This function frees a YUV overlay created by GAL_CreateYUVOverlay. Parameters: overlay  The video overlay to be freed. Note: Only defined for _USE_NEWGAL. See also: GAL_CreateYUVOverlay

int GAL_LockYUVOverlay (  GAL_Overlay *  overlay  )

Locks an overlay for direct access. Note: Only defined for _USE_NEWGAL. See also: GAL_UnlockYUVOverlay

void GAL_UnlockYUVOverlay (  GAL_Overlay *  overlay  )

Unlocks a locked overlay when you are done. Note: Only defined for _USE_NEWGAL. See also: GAL_LockYUVOverlay

---