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
17
18<h2>Description</h2>
19
20<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.
21</P>
22<h2>Coverage</h2>
23<TABLE border="1" cellpadding="3" cellspacing="0.1" width="640">
24  <tr>
25<TD width="30%" bgcolor="#C0C0C0"><em><strong>Functions</strong></em></TD>
26<TD width="25%" bgcolor="#C0C0C0"><em><strong>Parameters</strong></em></TD>
27<TD width="45%" bgcolor="#C0C0C0"><em><strong>Description</strong></em></TD>
28    </tr>
29  <tr>
30<TD width="30%"><a href="../../../gx/Lighting/GXInitLightPos.html"><code>GXInitLightPos</code></a></TD>
31<TD width="25%"><font face="Courier New"><em><strong>Position coordinate (x, y, z)</strong></em></font></TD>
32<TD width="45%">Various values.</TD>
33    </tr>
34  <tr>
35<TD width="30%"><a href="../../../gx/Lighting/GXInitLightColor.html"><code>GXInitLightColor</code></a></TD>
36<TD width="25%"><font face="Courier New"><em><strong>Light color</strong></em></font></TD>
37<TD width="45%">Various values.</TD>
38    </tr>
39  <tr>
40<TD width="30%" rowspan="7"><a href="../../../gx/Lighting/GXSetChanCtrl.html"><code>GXSetChanCtrl</code></a></TD>
41<TD width="25%"><font face="Courier New"><em><strong>Color channel ID</strong></em></font></TD>
42<TD width="45%">Always <font face="Courier New">GX_COLOR0</font>.</TD>
43    </tr>
44  <tr>
45<TD width="25%"><font face="Courier New"><em><strong>Channel enable</strong></em></font></TD>
46<TD width="45%">Always <font face="Courier New">GX_ENABLE</font>.</TD>
47    </tr>
48  <tr>
49<TD width="25%"><font face="Courier New"><em><strong>Ambient color source</strong></em></font></TD>
50<TD width="45%">Always register source.</TD>
51    </tr>
52  <tr>
53<TD width="25%"><font face="Courier New"><em><strong>Material color source</strong></em></font></TD>
54<TD width="45%">Always register source.</TD>
55    </tr>
56  <tr>
57<TD width="25%"><font face="Courier New"><em><strong>Light mask</strong></em></font></TD>
58<TD width="45%">Always <font face="Courier New">GX_LIGHT0</font>.</TD>
59    </tr>
60  <tr>
61<TD width="25%"><font face="Courier New"><em><strong>Diffusion function</strong></em></font></TD>
62<TD width="45%"><strong><font face="Courier New">GX_DF_CLAMP</font></strong> / <strong><font face="Courier New">GX_DF_SIGN</font></strong>.</TD>
63    </tr>
64  <tr>
65<TD width="25%"><font face="Courier New"><em><strong>Attenuation function</strong></em></font></TD>
66<TD width="45%">Always <font face="Courier New">GX_AF_NONE</font>.</TD>
67    </tr>
68  <tr>
69<TD width="30%"><a href="../../../gx/Lighting/GXSetChanAmbColor.html"><code>GXSetChanAmbColor</code></a></TD>
70<TD width="25%"><font face="Courier New"><em><strong>Ambient color</strong></em></font></TD>
71<TD width="45%">Various values.</TD>
72    </tr>
73  <tr>
74<TD width="30%"><a href="../../../gx/Lighting/GXSetChanMatColor.html"><code>GXSetChanMatColor</code></a></TD>
75<TD width="25%"><font face="Courier New"><em><strong>Material color</strong></em></font></TD>
76<TD width="45%">Various values.</TD>
77    </tr>
78</TABLE>
79<h2>Operation Method</h2>
80
81<P>START exits the test.</P>
82<P>The Control Stick moves the light. </P>
83<P>The C Stick rotates the model. </P>
84<P>The A Button changes the model. </P>
85<P>The B Button toggles the diffusion function (clamped/unclamped).
86</P>
87<P>The X/Y Buttons select an item to be controlled in the following order: Ambient, Light, Material. </P>
88<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.
89</P>
90<h2>Snapshot</h2>
91<P>Looks at a sphere from an angle opposite that of the light with the unclamped diffuse function.
92</P>
93<P><IMG src="./images/lit-unclamp-0.jpg" alt="lit-unclamp-0.jpg (5065 bytes)" width="320" height="240"></p>
94
95<P>Looks at a torus from an angle perpendicular to that of the light with the unclamped diffuse function.
96</P>
97<P><IMG src="./images/lit-unclamp-1.jpg" alt="lit-unclamp-1.jpg (6902 bytes)" width="320" height="240"></p>
98
99<h2>Required Data Files</h2>
100
101<p>None.</p>
102<H2>Revision History</H2>
103<P>2006/03/01 Initial version.</P>
104<hr>
105<P>CONFIDENTIAL</p>
106</BODY>
107</HTML>