group__yuv__fns.htm

MINIGUI1.6开发API

    <td>

<p>
Creates a video output overlay on a DC. 
<p>
This function creates a video output overlay on the given DC <em>hdc</em>. Calling the returned surface an <em>overlay</em> is something of a misnomer because the contents of the display DC <em>hdc</em> underneath the area where the overlay is shown is undefined - it may be overwritten with the converted YUV data.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>width</em>&nbsp;</td><td>The expected width of the video overlay. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>height</em>&nbsp;</td><td>The expected height of the video overlay. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>format</em>&nbsp;</td><td>The expected video overlay format, can be one of the following values:</td></tr>
  </table>
</dl>
<ul>
<li>GAL_YV12_OVERLAY<br>
 Planar mode: Y + V + U (3 planes)</li><li>GAL_IYUV_OVERLAY<br>
 Planar mode: Y + U + V (3 planes)</li><li>GAL_YUY2_OVERLAY<br>
 Packed mode: Y0+U0+Y1+V0 (1 plane)</li><li>GAL_UYVY_OVERLAY<br>
 Packed mode: U0+Y0+V0+Y1 (1 plane)</li><li>GAL_YVYU_OVERLAY<br>
 Packed mode: Y0+V0+Y1+U0 (1 plane)</li></ul>
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>hdc</em>&nbsp;</td><td>The device context.</td></tr>
  </table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>A GAL_Overlay object on success, NULL on error.</dd></dl>
<dl compact><dt><b>Note:</b></dt><dd>Only defined for _USE_NEWGAL.</dd></dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__yuv__fns.htm#ga2">GAL_LockYUVOverlay</a>, <a class="el" href="group__yuv__fns.htm#ga4">GAL_FreeYUVOverlay</a>, <a href="http://www.webartz.com/fourcc/indexyuv.htm">http://www.webartz.com/fourcc/indexyuv.htm</a> </dd></dl>
    </td>
  </tr>
</table>
<a class="anchor" name="ga5" doxytag="gdi.h::DisplayYUVOverlay"></a><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
  <tr>
    <td class="mdRow">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top">void GUIAPI DisplayYUVOverlay           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top"><a class="el" href="struct__GAL__Overlay.htm">GAL_Overlay</a> *&nbsp;</td>
          <td class="mdname" nowrap> <em>overlay</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap>const <a class="el" href="struct__RECT.htm">RECT</a> *&nbsp;</td>
          <td class="mdname" nowrap> <em>dstrect</em></td>
        </tr>
        <tr>
          <td class="md"></td>
          <td class="md">)&nbsp;</td>
          <td class="md" colspan="2"></td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Blits a video overlay to the screen. 
<p>
Calling this function will blit the video overly <em>overlay</em> 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 <em>dstrect</em> is in screen coordinate system.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>overlay</em>&nbsp;</td><td>The video overlay to be displayed. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>dstrect</em>&nbsp;</td><td>The destination rectangle. It may be different from that of the overlay, but currently only 2x scaling is supported</td></tr>
  </table>
</dl>
<dl compact><dt><b>Note:</b></dt><dd>Only defined for _USE_NEWGAL.</dd></dl>
<dl compact><dt><b>See also:</b></dt><dd>GAL_CreateYUVOverlay, <a class="el" href="group__yuv__fns.htm#ga2">GAL_LockYUVOverlay</a> </dd></dl>
    </td>
  </tr>
</table>
<a class="anchor" name="ga4" doxytag="gdi.h::GAL_FreeYUVOverlay"></a><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
  <tr>
    <td class="mdRow">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top">void GAL_FreeYUVOverlay           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top"><a class="el" href="struct__GAL__Overlay.htm">GAL_Overlay</a> *&nbsp;</td>
          <td class="mdname1" valign="top" nowrap> <em>overlay</em>          </td>
          <td class="md" valign="top">&nbsp;)&nbsp;</td>
          <td class="md" nowrap></td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Frees a YUV overlay. 
<p>
This function frees a YUV overlay created by <em>GAL_CreateYUVOverlay</em>.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>overlay</em>&nbsp;</td><td>The video overlay to be freed.</td></tr>
  </table>
</dl>
<dl compact><dt><b>Note:</b></dt><dd>Only defined for _USE_NEWGAL.</dd></dl>
<dl compact><dt><b>See also:</b></dt><dd>GAL_CreateYUVOverlay </dd></dl>
    </td>
  </tr>
</table>
<a class="anchor" name="ga2" doxytag="gdi.h::GAL_LockYUVOverlay"></a><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
  <tr>
    <td class="mdRow">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top">int GAL_LockYUVOverlay           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top"><a class="el" href="struct__GAL__Overlay.htm">GAL_Overlay</a> *&nbsp;</td>
          <td class="mdname1" valign="top" nowrap> <em>overlay</em>          </td>
          <td class="md" valign="top">&nbsp;)&nbsp;</td>
          <td class="md" nowrap></td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Locks an overlay for direct access. 
<p>
<dl compact><dt><b>Note:</b></dt><dd>Only defined for _USE_NEWGAL.</dd></dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__yuv__fns.htm#ga3">GAL_UnlockYUVOverlay</a> </dd></dl>
    </td>
  </tr>
</table>
<a class="anchor" name="ga3" doxytag="gdi.h::GAL_UnlockYUVOverlay"></a><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
  <tr>
    <td class="mdRow">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top">void GAL_UnlockYUVOverlay           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top"><a class="el" href="struct__GAL__Overlay.htm">GAL_Overlay</a> *&nbsp;</td>
          <td class="mdname1" valign="top" nowrap> <em>overlay</em>          </td>
          <td class="md" valign="top">&nbsp;)&nbsp;</td>
          <td class="md" nowrap></td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Unlocks a locked overlay when you are done. 
<p>
<dl compact><dt><b>Note:</b></dt><dd>Only defined for _USE_NEWGAL.</dd></dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__yuv__fns.htm#ga2">GAL_LockYUVOverlay</a> </dd></dl>
    </td>
  </tr>
</table>
<hr size="1"><address style="align: right;"><small>Generated on Thu Nov 22 15:35:54 2007 for MiniGUI V1.6.10 API Reference by&nbsp;
<a href="http://www.doxygen.org/index.html">
<img src="http://www.minigui.com/api_ref/1.6.10/doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.4.2 </small></address>
</body>
</html>