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-texture</title>
10</head>
11
12<body>
13
14<h1 align="left">lit-texture</h1>
15
16<h2>Description</h2>
17<p>This program tests a simple combination of lighting and texture. You can control each color component of the light, ambient, and material. Several TEV operations are also available.
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>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>GX_AF_NONE</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%">Various values.</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%">Various values.</TD>
75    </tr>
76  <tr>
77<TD width="30%" rowspan="2"><a href="../../../gx/Tev/GXSetTevOp.html"><code>GXSetTevOp</code></a></TD>
78<TD width="25%"><SPAN class="argument">TEV stage ID</SPAN></TD>
79<TD width="45%">Always <CODE>GX_TEVSTAGE0</CODE></TD>
80    </tr>
81  <tr>
82<TD width="25%"><SPAN class="argument">Mode</SPAN></TD>
83<TD width="45%"><strong><CODE>GX_MODULATE</CODE></strong>, <strong><CODE>GX_DECAL</CODE></strong>, <strong><CODE>GX_PASSCLR</CODE></strong>, <strong><CODE>GX_REPLACE</CODE></strong>.</TD>
84    </tr>
85</TABLE>
86
87<h2>Using the Demo</h2>
88<P>START exits the test.</P>
89<P>The Control Stick moves the light. </P>
90<P>The C Stick rotates the model. </P>
91<P>The A button changes the model. </P>
92<P>The B button changes the TEV operation mode.</P>
93<P>The X/Y buttons select an item to control in the following order:<BR>[ Ambient (R-G-B) -- Light (R-G-B) -- Material (R-G-B) ] </P>
94<P>The L/R triggers change the value of the selected item.</P>
95
96<h2>Snapshot</h2>
97<P>A textured dodecahedron with white light. TEV process is <CODE>GX_MODULATE</CODE>.</P>
98<P><IMG src="./images/lit-texture-0.jpg" alt="lit-texture-0.jpg (18097 bytes)" width="480" height="360"></p>
99
100<P>A textured dodecahedron with white light. TEV process is <CODE>GX_DECAL</CODE>.</P>
101<P><IMG src="./images/lit-texture-1.jpg" alt="lit-texture-1.jpg (19984 bytes)" width="480" height="360"></p>
102
103<h2>Required Data Files</h2>
104<p>None.</p>
105
106<H2>Revision History</H2>
107<P>
1082006/03/01 Initial version.<br>
109</P>
110
111<hr><p>CONFIDENTIAL</p></body>
112</html>