Sophie: directfb-doc-1.7.5-4.mga5 noarch

directfb-doc-1.7.5-4.mga5.noarch.rpm

<HTML>
<STYLE>
  <!--
    A{textdecoration:none}
  -->
</STYLE>
<STYLE type="text/css">
  A:link, A:visited, A:active { text-decoration: none; }
</STYLE>
<HEAD>
  <TITLE>IDirectFBSurface - SetSourceMask [DirectFB Reference Manual]</TITLE>
</HEAD>
<BODY bgcolor=#C0C8D8 link=#2369E0 vlink=#2369E0 text=#232323>

<TABLE width=100% bgcolor=#8090A0 border=0 cellspacing=0 cellpadding=5>
  <TR><TD width=30%>
    <A href="http://www.directfb.org"><IMG border=0 src="dfb_logo-alpha.png"></A>
  </TD><TD align=right>
    &nbsp;&nbsp;    <A href="index.html"><FONT size=+3 color=#203040>Reference Manual - 1.7.5</FONT></A>
  </TD></TR>
  <TR><TD colspan=2 align=center bgcolor=#284460>
    <TABLE border=0 cellspacing=0 cellpadding=0>
      <TR><TD nowrap align=right width=50%>
        <BIG><FONT color=#D0D0D0><A href="IDirectFBSurface.html">  <FONT color=#D0D0D0>IDirectFBSurface</FONT></A>&nbsp;</FONT></BIG>
      </TD><TD nowrap align=left width=50%>
        <BIG><FONT color=#E09040>&nbsp;SetSourceMask</FONT></BIG>
      </TD></TR>
    </TABLE>
  </TD></TR>
</TABLE>

<H4>
        Set the surface to be used as a mask for blitting.
</H4>
  <TABLE border=0 cellspacing=4 cellpadding=2 bgcolor=#D8E0E8>
    <TR><TD colspan=5><I><FONT color=#425469><A href="types.html#DFBResult">DFBResult</A> <b>SetSourceMask (</b></FONT></I></TD></TR>
    <TR><TD width=50>
      &nbsp;
    </TD><TD valign=top>
      <A href="IDirectFBSurface.html">IDirectFBSurface</A>
    </TD><TD width=20>&nbsp;</TD><TD align=right>
      <FONT color=#424242><B>*</B></FONT>
    </TD><TD valign=top>
      <FONT color=#234269><B>thiz,</B></FONT>
    </TD></TR>
    <TR><TD width=50>
      &nbsp;
    </TD><TD valign=top>
      <A href="IDirectFBSurface.html">IDirectFBSurface</A>
    </TD><TD width=20>&nbsp;</TD><TD align=right>
      <FONT color=#424242><B>*</B></FONT>
    </TD><TD valign=top>
      <FONT color=#234269><B>mask,</B></FONT>
    </TD></TR>
    <TR><TD width=50>
      &nbsp;
    </TD><TD valign=top>
      int
    </TD><TD width=20>&nbsp;</TD><TD align=right>
      <FONT color=#424242><B></B></FONT>
    </TD><TD valign=top>
      <FONT color=#234269><B>x,</B></FONT>
    </TD></TR>
    <TR><TD width=50>
      &nbsp;
    </TD><TD valign=top>
      int
    </TD><TD width=20>&nbsp;</TD><TD align=right>
      <FONT color=#424242><B></B></FONT>
    </TD><TD valign=top>
      <FONT color=#234269><B>y,</B></FONT>
    </TD></TR>
    <TR><TD width=50>
      &nbsp;
    </TD><TD valign=top>
      <A href="types.html#DFBSurfaceMaskFlags">DFBSurfaceMaskFlags</A>
    </TD><TD width=20>&nbsp;</TD><TD align=right>
      <FONT color=#424242><B></B></FONT>
    </TD><TD valign=top>
      <FONT color=#234269><B>flags</B></FONT>
    </TD></TR>
    <TR><TD colspan=5><I><FONT color=#425469><b>);</b></FONT></I></TD></TR>
  </TABLE>
</P>
<P>
        The <b>mask</b> applies when DSBLIT_SRC_MASK_ALPHA or DSBLIT_SRC_MASK_COLOR is used.
 </P><P>
        Depending on the <b>flags</b> reading either starts at a fixed location in the mask with
        absolute <b>x</b> and <b>y</b>, or at the same location as in the source, with <b>x</b>
        and <b>y</b> used as an offset.
 </P><P>
        <i>Example with DSMF_STENCIL:</i>
        <pre>
              Blit from <b>19,  6</b> in the source
                    and <b> 0,  0</b> in the mask (<b>x =  0, y =  0</b>)
                     or <b>-5, 17</b>             (<b>x = -5, y = 17</b>)
                     or <b>23, 42</b>             (<b>x = 23, y = 42</b>)
        </pre>
 </P><P>
        <i>Example without:</i>
        <pre>
              Blit from <b>19,  6</b> in the source
                    and <b>19,  6</b> in the mask (<b>x =  0, y =  0</b>)
                     or <b>14, 23</b>             (<b>x = -5, y = 17</b>)
                     or <b>42, 48</b>             (<b>x = 23, y = 42</b>)
        </pre>
 </P><P>
        See also <a href="IDirectFBSurface_SetBlittingFlags.html">IDirectFBSurface::SetBlittingFlags()</a>.
</P>

<TABLE width=100% bgcolor=#E0E8F0 border=0 cellspacing=1 cellpadding=3>
  <TR><TD width=100>
    <a rel="license" href="http://creativecommons.org/licenses/by-sa/3.0/">    <img alt="Creative Commons License" style="border-width:0" border="0"     src="http://i.creativecommons.org/l/by-sa/3.0/88x31.png" />    </a>  </TD><TD>
    This work is licensed under a    <a rel="license" href="http://creativecommons.org/licenses/by-sa/3.0/">    Creative Commons Attribution-Share Alike 3.0 License</a>  </TD></TR>
</TABLE>
</BODY>
</HTML>