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-unclamp</title>
10</head>
11
12<body>
13
14<h1 align="left">lit-unclamp</h1>
15
16<h2>Description</h2>
17<P>This program tests the unclamped diffusion function. You can control the scale of the diffusion function by changing the light and ambient color to control the bias.
18</P>
19
20<h2>Coverage</h2>
21<TABLE border="1" cellpadding="3" cellspacing="0.1" width="640">
22  <tr>
23<TD width="30%" bgcolor="#C0C0C0"><em><strong>Functions</strong></em></TD>
24<TD width="25%" bgcolor="#C0C0C0"><em><strong>Parameters</strong></em></TD>
25<TD width="45%" bgcolor="#C0C0C0"><em><strong>Description</strong></em></TD>
26    </tr>
27  <tr>
28<TD width="30%"><a href="../../../gx/Lighting/GXInitLightPos.html"><code>GXInitLightPos</code></a></TD>
29<TD width="25%"><SPAN class="argument">Position coordinate (x, y, z)</SPAN></TD>
30<TD width="45%">Various values.</TD>
31    </tr>
32  <tr>
33<TD width="30%"><a href="../../../gx/Lighting/GXInitLightColor.html"><code>GXInitLightColor</code></a></TD>
34<TD width="25%"><SPAN class="argument">Light color</SPAN></TD>
35<TD width="45%">Various values.</TD>
36    </tr>
37  <tr>
38<TD width="30%" rowspan="7"><a href="../../../gx/Lighting/GXSetChanCtrl.html"><code><CODE>GXSetChanCtrl</CODE></code></a></TD>
39<TD width="25%"><SPAN class="argument">Color channel ID</SPAN></TD>
40<TD width="45%">Always <CODE>GX_COLOR0</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%"><strong><CODE>GX_DF_CLAMP</CODE></strong> / <strong><CODE>GX_DF_SIGN</CODE></strong></TD>
61    </tr>
62  <tr>
63<TD width="25%"><SPAN class="argument">Attenuation function</SPAN></TD>
64<TD width="45%">Always <CODE>GX_AF_NONE</CODE></TD>
65    </tr>
66  <tr>
67<TD width="30%"><a href="../../../gx/Lighting/GXSetChanAmbColor.html"><code><CODE>GXSetChanAmbColor</CODE></code></a></TD>
68<TD width="25%"><SPAN class="argument">Ambient color</SPAN></TD>
69<TD width="45%">Various values.</TD>
70    </tr>
71  <tr>
72<TD width="30%"><a href="../../../gx/Lighting/GXSetChanMatColor.html"><code><CODE>GXSetChanMatColor</CODE></code></a></TD>
73<TD width="25%"><SPAN class="argument">Material color</SPAN></TD>
74<TD width="45%">Various values.</TD>
75    </tr>
76</TABLE>
77
78<h2>Using the Demo</h2>
79<P>START exits the test.</P>
80<P>The Control Stick moves the light. </P>
81<P>The C Stick rotates the model. </P>
82<P>The A Button changes the model. </P>
83<P>The B Button toggles the diffusion function (clamped/unclamped).</P>
84<P>The X/Y Buttons select an item to be controlled in the following order: Ambient, Light, Material. </P>
85<P>The L/R triggers change the brightness value of the selected item. This value is used as the R/G/B value of the selected item.</P>
86
87<h2>Snapshot</h2>
88<P>Looks at a sphere from an angle opposite that of the light with the unclamped diffuse function.</P>
89<P><IMG src="./images/lit-unclamp-0.jpg" alt="lit-unclamp-0.jpg (5065 bytes)" width="320" height="240"></p>
90
91<P>Looks at a torus from an angle perpendicular to that of the light with the unclamped diffuse function.</P>
92<P><IMG src="./images/lit-unclamp-1.jpg" alt="lit-unclamp-1.jpg (6902 bytes)" width="320" height="240"></p>
93
94<h2>Required Data Files</h2>
95<p>None.</p>
96
97<H2>Revision History</H2>
98<P>
992006/03/01 Initial version.<br>
100</P>
101
102<hr><p>CONFIDENTIAL</p></body>
103</html>