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>lit-dist-atn</title>
10</head>
11
12<body>
13
14<h1 align="left">lit-dist-atn</h1>
15
16<h2>Description</h2>
17
18<p>This program tests distance attenuation control. One light illuminates the standing wall at a fixed interval.
19</p>
20
21<h2>Coverage</h2>
22<TABLE border="1" cellpadding="3" cellspacing="0.1" width="640">
23  <tr>
24<TD width="30%" bgcolor="#C0C0C0"><em><strong>Functions</strong></em></TD>
25<TD width="25%" bgcolor="#C0C0C0"><em><strong>Parameters</strong></em></TD>
26<TD width="45%" bgcolor="#C0C0C0"><em><strong>Description</strong></em></TD>
27    </tr>
28  <tr>
29<TD width="30%" rowspan="2"><a href="../../../gx/Lighting/GXInitLightAttn.html"><code>GXInitLightAttn</code></a></TD>
30<TD width="25%"><SPAN class="argument">Angular Attenuation Coefficients</SPAN></TD>
31<TD width="45%">Fixed values: ( a0 = 1, a1 = 0, a2 = 0 ).</TD>
32    </tr>
33  <tr>
34<TD width="25%"><SPAN class="argument">Distance Attenuation Coefficients</SPAN></TD>
35<TD width="45%"><strong>Some appropriate value sets.</strong></TD>
36    </tr>
37  <tr>
38<TD width="30%" rowspan="7"><a href="../../../gx/Lighting/GXSetChanCtrl.html"><code>GXSetChanCtrl</code></a></TD>
39<TD width="25%"><SPAN class="argument">Color channel ID</SPAN></TD>
40<TD width="45%">Always <CODE>GX_COLOR0A0</CODE>.</TD>
41    </tr>
42  <tr>
43<TD width="25%"><SPAN class="argument">Channel enable</SPAN></TD>
44<TD width="45%">Always <CODE>GX_ENABLE</CODE>.</TD>
45    </tr>
46  <tr>
47<TD width="25%"><SPAN class="argument">Ambient color source</SPAN></TD>
48<TD width="45%">Always register source.</TD>
49    </tr>
50  <tr>
51<TD width="25%"><SPAN class="argument">Material color source</SPAN></TD>
52<TD width="45%">Always register source.</TD>
53    </tr>
54  <tr>
55<TD width="25%"><SPAN class="argument">Light mask</SPAN></TD>
56<TD width="45%">Always <CODE>GX_LIGHT0</CODE>.</TD>
57    </tr>
58  <tr>
59<TD width="25%"><SPAN class="argument">Diffusion function</SPAN></TD>
60<TD width="45%">Always <CODE>GX_DF_CLAMP</CODE>.</TD>
61    </tr>
62  <tr>
63<TD width="25%"><SPAN class="argument">Attenuation function</SPAN></TD>
64<TD width="45%">Always <CODE><strong>GX_AF_SPOT</strong></CODE>.</TD>
65    </tr>
66  <tr>
67<TD width="30%"><a href="../../../gx/Lighting/GXSetChanAmbColor.html"><code>GXSetChanAmbColor</code></a></TD>
68<TD width="25%"><SPAN class="argument">Ambient color</SPAN></TD>
69<TD width="45%">Three colors.</TD>
70    </tr>
71  <tr>
72<TD width="30%"><a href="../../../gx/Lighting/GXSetChanMatColor.html"><code>GXSetChanMatColor</code></a></TD>
73<TD width="25%"><SPAN class="argument">Material color</SPAN></TD>
74<TD width="45%">Only one color.</TD>
75    </tr>
76</TABLE>
77
78<h2>Using the Demo</h2>
79<P>START exits the test.</P>
80<P>The L and R buttons change the distance attenuation coefficients (obtained from a table).</P>
81<P>The Control Stick moves the camera location.</P>
82
83<h2>Snapshot</h2>
84<P><IMG src="./images/lit-dist-atn.jpg" alt="lit-dist-atn.jpg (6258 bytes)" width="480" height="360"></p>
85
86<h2>Required Data Files</h2>
87<p>None.</p>
88
89<H2>Revision History</H2>
90<P>
912006/03/01 Initial version.<br>
92</P>
93
94<hr><p>CONFIDENTIAL</p></body>
95</html>