group__draw__fns.htm

MINIGUI1.6开发API

          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap>int&nbsp;</td>
          <td class="mdname" nowrap> <em>ang1</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap>int&nbsp;</td>
          <td class="mdname" nowrap> <em>ang2</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap><a class="el" href="group__draw__fns.htm#ga3">CB_ARC</a>&nbsp;</td>
          <td class="mdname" nowrap> <em>cb</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>
An arc generator. 
<p>
This is a general arc generator. When it generates a point on the arc, it will call the callback <em>cb</em> and pass the context <em>context</em>, the coordinates of the point.<p>
MiniGUI implements <em>CircleArc</em> function by using this generator.<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>context</em>&nbsp;</td><td>The context, will be passed to the callback <em>cb</em>. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>sx</em>&nbsp;</td><td>sx,sy: The center of the arc. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>sy</em>&nbsp;</td><td>sx,sy: The center of the arc. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>r</em>&nbsp;</td><td>The radius of the arc. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>ang1</em>&nbsp;</td><td>The start angle of the arc, relative to the 3 o'clock position, counter-clockwise, in 1/64ths of a degree. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>ang2</em>&nbsp;</td><td>The end angle of the arc, relative to angle1, in 1/64ths of a degree. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>cb</em>&nbsp;</td><td>The arc generator callback.</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><a class="el" href="group__draw__fns.htm#ga39">CircleArc</a>, <a class="el" href="group__draw__fns.htm#ga3">CB_ARC</a> </dd></dl>
    </td>
  </tr>
</table>
<a class="anchor" name="ga23" doxytag="gdi.h::CircleGenerator"></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 CircleGenerator           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top">void *&nbsp;</td>
          <td class="mdname" nowrap> <em>context</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap>int&nbsp;</td>
          <td class="mdname" nowrap> <em>sx</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap>int&nbsp;</td>
          <td class="mdname" nowrap> <em>sy</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap>int&nbsp;</td>
          <td class="mdname" nowrap> <em>r</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap><a class="el" href="group__draw__fns.htm#ga1">CB_CIRCLE</a>&nbsp;</td>
          <td class="mdname" nowrap> <em>cb</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>
A circle generator. 
<p>
This is a general circle generator, it will generate two points on the same horizontal scan line at every turn. When it generates the points on the circle, it will call the callback <em>cb</em> and pass the context <em>context</em>, the y-coordinate of the scan line, the x-coordinate of the left point on the scan line, and the x-coordinate of the right point. Note that in some cases, the left point and the right point will be the same.<p>
MiniGUI implements <em>Circle</em>, <em>FillCircle</em> and <em>InitCircleRegion</em> functions by using this generator.<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>context</em>&nbsp;</td><td>The context, will be passed to the callback <em>cb</em>. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>sx</em>&nbsp;</td><td>sx,sy: The center of the circle. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>sy</em>&nbsp;</td><td>sx,sy: The center of the circle. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>r</em>&nbsp;</td><td>The radius of the circle. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>cb</em>&nbsp;</td><td>The circle generator callback.</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><a class="el" href="group__draw__fns.htm#ga37">Circle</a>, <a class="el" href="group__draw__fns.htm#ga41">FillCircle</a>, <a class="el" href="group__region__fns.htm#ga23">InitCircleRegion</a>, <a class="el" href="group__draw__fns.htm#ga1">CB_CIRCLE</a></dd></dl>
Example:<p>
<div class="fragment"><pre class="fragment"><span class="comment">/*</span>
<span class="comment"> * Draw a circle which is 4 pixels wide by using CircleGenerator.</span>
<span class="comment"> */</span>
<span class="keyword">static</span> <span class="keywordtype">void</span> draw_circle_pixel (<span class="keywordtype">void</span>* context, <span class="keywordtype">int</span> x1, <span class="keywordtype">int</span> x2, <span class="keywordtype">int</span> y)
{
    <a class="code" href="group__handles.htm#ga2">HDC</a> hdc = (<a class="code" href="group__handles.htm#ga2">HDC</a>) context;

    <a class="code" href="group__draw__fns.htm#ga41">FillCircle</a> (hdc, x1, y, 2);
    <a class="code" href="group__draw__fns.htm#ga41">FillCircle</a> (hdc, x2, y, 2);
}

<span class="keywordtype">void</span> DrawMyCircle (<a class="code" href="group__handles.htm#ga2">HDC</a> hdc, <span class="keywordtype">int</span> x, <span class="keywordtype">int</span> y, <span class="keywordtype">int</span> r, <a class="code" href="group__gdi__types.htm#ga8">gal_pixel</a> pixel)
{
    <a class="code" href="group__gdi__types.htm#ga8">gal_pixel</a> old_brush;

    old_bursh = <a class="code" href="group__dc__attrs.htm#ga31">SetBrushColor</a> (hdc, pixle);

    <a class="code" href="group__draw__fns.htm#ga23">CircleGenerator</a> ((<span class="keywordtype">void</span>*)hdc, x, y, r, draw_circle_pixel);
    
    <a class="code" href="group__dc__attrs.htm#ga31">SetBrushColor</a> (hdc, old_brush);
}
</pre></div>     </td>
  </tr>
</table>
<a class="anchor" name="ga20" doxytag="gdi.h::DrawHVDotLine"></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 DrawHVDotLine           </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>int&nbsp;</td>
          <td class="mdname" nowrap> <em>x</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap>int&nbsp;</td>
          <td class="mdname" nowrap> <em>y</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap>int&nbsp;</td>
          <td class="mdname" nowrap> <em>w_h</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap><a class="el" href="group__simple__types.htm#ga0">BOOL</a>&nbsp;</td>
          <td class="mdname" nowrap> <em>H_V</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>
Draws a horizontal or vertical dot dash line. 
<p>
This function draws a horizontal or vertical dot dash line with the zero pen.<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>x</em>&nbsp;</td><td>x,y: The start point of the line. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>y</em>&nbsp;</td><td>x,y: The start point of the line. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>w_h</em>&nbsp;</td><td>The width of the line or horizontal dot line, or the height if you want to draw a vertical dot line. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>H_V</em>&nbsp;</td><td>Specify whether you want to draw a horizontal or vertical line. TRUE for horizontal, FALSE for vertical.</td></tr>
  </table>
</dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__draw__fns.htm#ga19">FocusRect</a> </dd></dl>
    </td>
  </tr>
</table>
<a class="anchor" name="ga38" doxytag="gdi.h::Ellipse"></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 Ellipse           </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>int&nbsp;</td>
          <td class="mdname" nowrap> <em>sx</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap>int&nbsp;</td>
          <td class="mdname" nowrap> <em>sy</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap>int&nbsp;</td>
          <td class="mdname" nowrap> <em>rx</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap>int&nbsp;</td>