1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<html>
3
4<head>
5<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
6<META name="GENERATOR" content="Microsoft FrontPage 5.0">
7<META http-equiv="Content-Style-Type" content="text/css">
8<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css">
9<title>GXSetChanAmbColor</title>
10</head>
11
12<body>
13
14<h1 align="left">GXSetChanAmbColor</h1>
15
16<h2>C Specification</h2>
17
18<dl>
19<dd><pre><CODE>#include &lt;revolution/gx.h&gt;</CODE></pre>
20  </dd>
21<dd><pre><CODE>void GXSetChanAmbColor(
22<a href="../Enumerated_Types/GXChannelID.html">GXChannelID</a>   chan,
23<a href="../Structures/GXColor.html">GXColor</a>       amb_color );</CODE></pre>
24  </dd>
25</dl>
26
27<h2>Arguments</h2>
28<TABLE border="1" cellpadding="3" cellspacing="0.1">
29  <tr>
30<TD width="120" bgcolor="#ffffe8"><em><strong><CODE><code><EM><STRONG>chan</STRONG></EM></code></CODE></strong></em></TD>
31<TD width="520">Color <a href="../Enumerated_Types/GXChannelID.html">channel</a>.&nbsp;Accepted values are:<BR>
32      <TABLE width="500" border="1" cellspacing="0.1">
33
34          <tr>
35<TD width="150" bgcolor="#C0C0C0">Name</TD>
36<TD width="350" bgcolor="#C0C0C0">Channel where the ambient color is updated</TD>
37          </tr>
38          <tr>
39<TD width="150"><code>GX_COLOR0A0</code></TD>
40<TD width="350">Color channel 0 + Alpha channel 0</TD>
41          </tr>
42          <tr>
43<TD width="150" height="20"><code>GX_COLOR0</code></TD>
44<TD width="350" height="20">Color channel 0 (only RGB components are used)</TD>
45          </tr>
46          <tr>
47<TD width="150"><code>GX_ALPHA0</code></TD>
48<TD width="350">Alpha channel 0 (only Alpha component is used)</TD>
49          </tr>
50          <tr>
51<TD width="150"><code>GX_COLOR1A1</code></TD>
52<TD width="350">Color channel 1 + Alpha channel 1</TD>
53          </tr>
54          <tr>
55<TD width="150"><code>GX_COLOR1</code></TD>
56<TD width="350">Color channel 1 (only RGB components are used)</TD>
57          </tr>
58          <tr>
59<TD width="150"><code>GX_ALPHA1</code></TD>
60<TD width="350">Alpha channel 1 (only Alpha component is used)</TD>
61          </tr>
62
63      </TABLE>
64      </TD>
65    </tr>
66  <tr>
67<TD width="120" bgcolor="#ffffe8"><em><strong><CODE>amb_color</CODE></strong></em></TD>
68<TD width="520">Ambient color</TD>
69    </tr>
70</TABLE>
71<h2>Return Values</h2>
72
73<p>None.</p>
74<H2>Description</H2>
75<P>This function sets the ambient color register for color channel <code><em><strong>chan</strong></em></code>. This color is used by the channel as the ambient color if the ambient source, set by <a href="GXSetChanCtrl.html"><code>GXSetChanCtrl</code></a>, is <code>GX_SRC_REG</code>.</P>
76
77<h2>See Also</h2>
78
79<p><A href="GXSetChanMatColor.html"><CODE>GXSetChanMatColor</CODE></A></p>
80<H2>Revision History</H2>
81<P>03/01/2006 Initial version.</P></body>
82</html>