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-multi</title>
10</head>
11
12<body>
13<h1 align="left">lit-multi</h1>
14
15
16
17<h2>Description</h2>
18
19<P>This program does a test for multiple lights and light masks. Eight lights move around the model. All lights are used simultaneously in one color channel. You can control the position of each light and enable or disable each individual light.
20</P>
21
22<h2>Coverage</h2>
23<p>This test applies all combination patterns of light mask parameters.</p>
24<TABLE border="1" cellpadding="3" cellspacing="0.1" width="640">
25  <tr>
26<TD width="30%" bgcolor="#C0C0C0"><em><strong>Functions</strong></em></TD>
27<TD width="25%" bgcolor="#C0C0C0"><em><strong>Parameters</strong></em></TD>
28<TD width="45%" bgcolor="#C0C0C0"><em><strong>Description</strong></em></TD>
29    </tr>
30  <tr>
31<TD width="30%"><a href="../../../gx/Lighting/GXInitLightPos.html"><code>GXInitLightPos</code></a></TD>
32<TD width="25%"><SPAN class="argument">Position coordinate (x, y, z)</SPAN></TD>
33<TD width="45%">Various values.</TD>
34    </tr>
35  <tr>
36<TD width="30%"><a href="../../../gx/Lighting/GXInitLightColor.html"><code>GXInitLightColor</code></a></TD>
37<TD width="25%"><SPAN class="argument">Light color</SPAN></TD>
38<TD width="45%">Four colors.</TD>
39    </tr>
40  <tr>
41<TD width="30%"><a href="../../../gx/Lighting/GXLoadLightObjImm.html"><code>GXLoadLightObjImm</code></a></TD>
42<TD width="25%"><SPAN class="argument">Light ID</SPAN></TD>
43<TD width="45%"><CODE><strong>GX_LIGHT0 ~ GX_LIGHT7.</strong></CODE></TD>
44    </tr>
45  <tr>
46<TD width="30%" rowspan="7"><a href="../../../gx/Lighting/GXSetChanCtrl.html"><code>GXSetChanCtrl</code></a></TD>
47<TD width="25%"><SPAN class="argument">Color channel ID</SPAN></TD>
48<TD width="45%">Always <CODE>GX_COLOR0</CODE>.</TD>
49    </tr>
50  <tr>
51<TD width="25%"><SPAN class="argument">Channel enable</SPAN></TD>
52<TD width="45%">Always <CODE>GX_ENABLE</CODE>.</TD>
53    </tr>
54  <tr>
55<TD width="25%"><SPAN class="argument">Ambient color source</SPAN></TD>
56<TD width="45%">Always <CODE>GX_SRC_REG</CODE>.</TD>
57    </tr>
58  <tr>
59<TD width="25%"><SPAN class="argument">Material color source</SPAN></TD>
60<TD width="45%">Always <CODE>GX_SRC_REG</CODE>.</TD>
61    </tr>
62  <tr>
63<TD width="25%"><SPAN class="argument">Light mask</SPAN></TD>
64<TD width="45%"><strong>All possible combinations.</strong></TD>
65    </tr>
66  <tr>
67<TD width="25%"><SPAN class="argument">Diffusion function</SPAN></TD>
68<TD width="45%">Always <CODE>GX_DF_CLAMP</CODE>.</TD>
69    </tr>
70  <tr>
71<TD width="25%"><SPAN class="argument">Attenuation function</SPAN></TD>
72<TD width="45%">Always <CODE>GX_AF_NONE</CODE>.</TD>
73    </tr>
74  <tr>
75<TD width="30%" height="38" rowspan="2"><a href="../../../gx/Lighting/GXSetChanAmbColor.html"><code>GXSetChanAmbColor</code></a></TD>
76<TD width="25%" height="19"><SPAN class="argument">Color channel ID</SPAN></TD>
77<TD width="45%" height="19">Only <CODE>GX_COLOR0A0</CODE>.</TD>
78    </tr>
79  <tr>
80<TD width="25%" height="19"><SPAN class="argument">Ambient color</SPAN></TD>
81<TD width="45%" height="19">Only one color.</TD>
82    </tr>
83  <tr>
84<TD width="30%" height="38" rowspan="2"><a href="../../../gx/Lighting/GXSetChanMatColor.html"><code>GXSetChanMatColor</code></a></TD>
85<TD width="25%" height="19"><SPAN class="argument">Color channel ID</SPAN></TD>
86<TD width="45%" height="19">Only <CODE>GX_COLOR0A0</CODE>.</TD>
87    </tr>
88  <tr>
89<TD width="25%" height="19"><SPAN class="argument">Material color</SPAN></TD>
90<TD width="45%" height="19">Cycles through 4 colors.</TD>
91    </tr>
92</TABLE>
93
94<h2>Using the Demo</h2>
95<P>START exits the test.</P>
96<P>The L and R Buttons select a light. </P>
97<P>The Control Stick moves the selected light.<BR>The C Stick rotates the model. </P>
98<P>The A button toggles the selected light on and off (if a light is selected).</P>
99<P>The X button stops and starts light animation.</P>
100<P>The Y button changes the material color of the model.</P>
101<P>The B button changes the model shape. </P>
102
103<h2>Snapshot</h2>
104<p>All lights turned on.</p>
105<P><IMG src="./images/lit-multi-0.jpg" alt="lit-multi-0.jpg (15184 bytes)" width="640" height="480"></p>
106
107<p>Four lights (<CODE>GX_LIGHT4-7</CODE>) are enabled. Others are disabled.</p>
108<P><IMG src="./images/lit-multi-15.jpg" alt="lit-multi-15.jpg (12257 bytes)" width="640" height="480"></p>
109
110<p>No light is enabled.</p>
111<P><IMG src="./images/lit-multi-255.jpg" alt="lit-multi-255.jpg (9479 bytes)" width="640" height="480"></p>
112
113<p>All lights turned on. Since bright yellow is used as the material color, the blue component is weakened.</p>
114<P><IMG src="./images/lit-multi-256.jpg" alt="lit-multi-256.jpg (15128 bytes)" width="640" height="480"></p>
115
116<h2>Required Data Files</h2>
117<p>None.</p>
118
119<H2>Revision History</H2>
120<P>
1212006/03/01 Initial version.<br>
122</P>
123
124<hr><p>CONFIDENTIAL</p></body>
125</html>