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-basic</title>
10</head>
11
12<body>
13
14<h1 align="left">lit-basic</h1>
15
16
17
18<h2>Description</h2>
19
20<P>This program tests the basic lighting channel controls using one light positioned at the viewpoint and directed down the Z-axis. Three identical models are rendered, each rotating about a different axis. You can select any of the <code>GXDraw*</code> procedural models, change ambient and material register colors, and turn smooth shading on and off.</P>
21<h2>Coverage</h2>
22
23<p>This test uses only the <code><font face="Courier New">GX_COLOR0</font></code> channel.</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%" rowspan="3"><a href="../../../gx/Lighting/GXSetChanCtrl.html"><code>GXSetChanCtrl</code></a>&nbsp;&nbsp;</TD>
32<TD width="25%"><em><strong><font face="Courier New">Channel enable</font></strong></em></TD>
33<TD width="45%">Channel enable toggled ON/OFF.</TD>
34    </tr>
35  <tr>
36<TD width="25%"><em><strong><font face="Courier New">Material color source</font></strong></em></TD>
37<TD width="45%">Always register source.</TD>
38    </tr>
39  <tr>
40<TD width="25%"><em><strong><font face="Courier New">Ambient color source</font></strong></em></TD>
41<TD width="45%">Always register source.</TD>
42    </tr>
43  <tr>
44<TD width="30%"><a href="../../../gx/Lighting/GXSetChanAmbColor.html"><code>GXSetChanAmbColor</code></a></TD>
45<TD width="25%"><em><strong><font face="Courier New">Ambient color</font></strong></em></TD>
46<TD width="45%">Cycles through 6 colors.</TD>
47    </tr>
48  <tr>
49<TD width="30%"><a href="../../../gx/Lighting/GXSetChanMatColor.html"><code>GXSetChanMatColor</code></a></TD>
50<TD width="25%"><em><strong><font face="Courier New">Material color</font></strong></em></TD>
51<TD width="45%">Cycles through 6 colors.</TD>
52    </tr>
53</TABLE>
54<h2>Operation Method</h2>
55<P>The test prints a menu of choices.</P>
56<P> The X/Y buttons navigate up and down in the menu.</P>
57<P>The L and R Buttons cycle through states of the current menu item.
58</P>
59<P>The A Button dumps the current state settings.
60</P>
61<P>START exits the test.</P>
62<h2>Snapshot</h2>
63
64<P>Channel disabled, material=red, ambient=black, and model type is cylinder.</P>
65<P><IMG src="./images/lit-basic-0.jpg" alt="lit-basic-0.jpg (9916 bytes)" width="640" height="480"></p>
66
67<P>Channel enabled. material=black, ambient=white, and model type is sphere.</P>
68<P><IMG src="./images/lit-basic-1.jpg" alt="lit-basic-1.jpg (6173 bytes)" width="640" height="480"></p>
69
70<P>Channel enabled. material = green, ambient = gray, and model type is torus.</P>
71<P><IMG src="./images/lit-basic-2.jpg" alt="lit-basic-2.jpg (9631 bytes)" width="640" height="480"></p>
72
73<P>Channel enabled. material=white, ambient=blue, and model type is icosahedron.</P>
74<P><IMG src="./images/lit-basic-3.jpg" alt="lit-basic-3.jpg (9904 bytes)" width="640" height="480"></p>
75
76<h2>Required Data Files</h2>
77
78<p>None.</p>
79<H2>Revision History</H2>
80<P>03/01/2006 Initial version.</P>
81</body>
82</html>