group__bmp__load__fns.htm

MINIGUI1.6开发API

<p>
Initializes the bitmap pixel format information of a BITMAP object. 
<p>
This function initializes the bitmap pixel format information of the BITMAP object pointed to by <em>bmp</em>. This includes <em>bmBitsPerPixel</em> and <em>bmBytesPerPixel</em> fields, and the private pixel format if the bitmap is a bitmap with alpha.<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>
    <tr><td valign="top"></td><td valign="top"><em>bmp</em>&nbsp;</td><td>The BITMAP object to be initialized. </td></tr>
  </table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>TRUE on success, FALSE on error.</dd></dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__bmp__load__fns.htm#ga21">InitBitmap</a>, <a class="el" href="group__bmp__struct.htm">Bitmap structure</a> </dd></dl>
    </td>
  </tr>
</table>
<a class="anchor" name="ga12" doxytag="gdi.h::InitMyBitmapSL"></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 InitMyBitmapSL           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top"><a class="el" href="struct__MG__RWops.htm">MG_RWops</a> *&nbsp;</td>
          <td class="mdname" nowrap> <em>area</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap>const char *&nbsp;</td>
          <td class="mdname" nowrap> <em>ext</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap><a class="el" href="struct__MYBITMAP.htm">MYBITMAP</a> *&nbsp;</td>
          <td class="mdname" nowrap> <em>my_bmp</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap><a class="el" href="struct__RGB.htm">RGB</a> *&nbsp;</td>
          <td class="mdname" nowrap> <em>pal</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>
Initializes scanline loader of the MYBITMAP object from a data source. 
<p>
This function initializes scanline loader of the MYBITMAP object from a data source.<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>area</em>&nbsp;</td><td>The data source. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>ext</em>&nbsp;</td><td>The extension of the type of this bitmap. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>my_bmp</em>&nbsp;</td><td>The pointer to the MYBITMAP object. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>pal</em>&nbsp;</td><td>The palette will be returned.</td></tr>
  </table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The initialized information which should be passed to LoadMyBitmapSL function, and NULL on error.</dd></dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__bmp__load__fns.htm#ga15">LoadMyBitmapEx</a>, <a class="el" href="group__bmp__load__fns.htm#ga13">LoadMyBitmapSL</a>, <a class="el" href="group__bmp__load__fns.htm#ga14">CleanupMyBitmapSL</a> </dd></dl>
    </td>
  </tr>
</table>
<a class="anchor" name="ga22" doxytag="gdi.h::InitSlaveScreen"></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"><a class="el" href="group__handles.htm#ga2">HDC</a> GUIAPI InitSlaveScreen           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top">const char *&nbsp;</td>
          <td class="mdname" nowrap> <em>name</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap>const char *&nbsp;</td>
          <td class="mdname" nowrap> <em>mode</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>
Initializes slave screen. 
<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>name</em>&nbsp;</td><td>The gal engine name. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>mode</em>&nbsp;</td><td>The display mode. For example : 640x480-16bpp. </td></tr>
  </table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>Valid handle on success, HDC_INVALID on failure. </dd></dl>
    </td>
  </tr>
</table>
<a class="anchor" name="ga5" doxytag="gdi.h::LoadBitmapEx"></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 GUIAPI LoadBitmapEx           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top"><a class="el" href="group__handles.htm#ga2">HDC</a>&nbsp;</td>
          <td class="mdname" nowrap> <em>hdc</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap><a class="el" href="struct__BITMAP.htm">PBITMAP</a>&nbsp;</td>
          <td class="mdname" nowrap> <em>pBitmap</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap><a class="el" href="struct__MG__RWops.htm">MG_RWops</a> *&nbsp;</td>
          <td class="mdname" nowrap> <em>area</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap>const char *&nbsp;</td>
          <td class="mdname" nowrap> <em>ext</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>
Loads a device-dependent bitmap from a general data source. 
<p>
This function loads a device-dependent bitmap from the data source <em>area</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>hdc</em>&nbsp;</td><td>The device context. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>pBitmap</em>&nbsp;</td><td>The pointer to the BITMAP object. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>area</em>&nbsp;</td><td>The data source. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>ext</em>&nbsp;</td><td>The extension of the type of this bitmap. </td></tr>
  </table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>0 on success, less than 0 on error.</dd></dl>
<dl compact><dt><b>Return values:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>ERR_BMP_OK</em>&nbsp;</td><td>Loading successfully </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>ERR_BMP_IMAGE_TYPE</em>&nbsp;</td><td>Not a valid bitmap. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>ERR_BMP_UNKNOWN_TYPE</em>&nbsp;</td><td>Not recongnized bitmap type. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>ERR_BMP_CANT_READ</em>&nbsp;</td><td>Read error. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>ERR_BMP_CANT_SAVE</em>&nbsp;</td><td>Save error. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>ERR_BMP_NOT_SUPPORTED</em>&nbsp;</td><td>Not supported bitmap type. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>ERR_BMP_MEM</em>&nbsp;</td><td>Memory allocation error. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>ERR_BMP_LOAD</em>&nbsp;</td><td>Loading error. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>ERR_BMP_FILEIO</em>&nbsp;</td><td>I/O failed. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>ERR_BMP_OTHER</em>&nbsp;</td><td>Other error. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>ERR_BMP_ERROR_SOURCE</em>&nbsp;</td><td>A error data source.</td></tr>
  </table>
</dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__bmp__load__fns.htm#ga6">LoadBitmapFromFile</a>, <a class="el" href="group__bmp__load__fns.htm#ga7">LoadBitmapFromMem</a> </dd></dl>
    </td>
  </tr>
</table>
<a class="anchor" name="ga6" doxytag="gdi.h::LoadBitmapFromFile"></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 GUIAPI LoadBitmapFromFile           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top"><a class="el" href="group__handles.htm#ga2">HDC</a>&nbsp;</td>
          <td class="mdname" nowrap> <em>hdc</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap><a class="el" href="struct__BITMAP.htm">PBITMAP</a>&nbsp;</td>
          <td class="mdname" nowrap> <em>pBitmap</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap>const char *&nbsp;</td>
          <td class="mdname" nowrap> <em>spFileName</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>
Loads a device-dependent bitmap from a file. 
<p>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__bmp__load__fns.htm#ga5">LoadBitmapEx</a> </dd></dl>
    </td>
  </tr>
</table>
<a class="anchor" name="ga7" doxytag="gdi.h::LoadBitmapFromMem"></a><p>
<table class="mdTable" cellpadding="2" cellspacing="0">