1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<HTML>
3<HEAD>
4<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
5<META name="GENERATOR" content="Microsoft FrontPage 5.0">
6<META http-equiv="Content-Style-Type" content="text/css">
7<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css">
8<TITLE>GXSetDstAlpha</TITLE>
9</HEAD>
10<BODY>
11<H1 align="left">GXSetDstAlpha</H1>
12
13<H2>Syntax</H2>
14<dl><dd><pre class="construction">
15#include &lt;revolution/gx.h&gt;
16
17void GXSetDstAlpha( <A href="../Enumerated_Types/GXBool.html">GXBool</A> enable, u8 alpha );
18</pre></dd></dl>
19
20<H2>Arguments</H2>
21<TABLE class="arguments" border="1" >
22  <TBODY>
23    <TR>
24<TH>enable</TH>
25<TD>When <SPAN class="argument">enable</SPAN> = <CODE>GX_TRUE</CODE> and the <A href="GXSetPixelFmt.html">pixel format</A> in the frame buffer supports destination alpha, <SPAN class="argument">alpha</SPAN> will be written to the frame buffer.</TD>
26    </TR>
27    <TR>
28<TH>alpha</TH>
29<TD>Constant alpha value.</TD>
30    </TR>
31  </TBODY>
32</TABLE>
33
34<H2>Return Values</H2>
35<P>None.</P>
36
37<H2>Description</H2>
38<P>This function sets a constant alpha value for writing to the embedded frame buffer (EFB).&nbsp;To be effective, the EFB pixel type must have an alpha channel. For more information, see the <A href="GXSetPixelFmt.html"><CODE>GXSetPixelFmt</CODE></A> function. The alpha comparison process (see the <A href="../Tev/GXSetAlphaCompare.html"><CODE>GXSetAlphaCompare</CODE></A> function) and the blending process (see the <A href="GXSetBlendMode.html"><CODE>GXSetBlendMode</CODE></A> function) may continue to use the input alpha (the output from the last TEV stage), but when the pixel color is written, the pixel alpha within EFB is overwritten with the constant alpha, <SPAN class="argument">alpha</SPAN>.</P>
39
40<H2>See Also</H2>
41<P class="reference">
42<A href="GXSetPixelFmt.html">GXSetPixelFmt</A>
43</P>
44
45<H2>Revision History</H2>
46<P>
472006/03/01 Initial version.<br>
48</P>
49
50<hr><p>CONFIDENTIAL</p></body>
51</HTML>