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<h2>Description</h2>
17<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>GXDrawDone*</CODE> procedural models, change ambient and material register colors, and turn smooth shading on and off.</P>
18
19<h2>Coverage</h2>
20<p>This test uses only the <CODE>GX_COLOR0</CODE> channel.</p>
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%" rowspan="3"><a href="../../../gx/Lighting/GXSetChanCtrl.html"><code>GXSetChanCtrl</code></a>&nbsp;</TD>
29<TD width="25%"><SPAN class="argument">Channel enable</SPAN></TD>
30<TD width="45%">Toggle ON/OFF.</TD>
31    </tr>
32  <tr>
33<TD width="25%"><SPAN class="argument">Material color source</SPAN></TD>
34<TD width="45%">Always register source.</TD>
35    </tr>
36  <tr>
37<TD width="25%"><SPAN class="argument">Ambient color source</SPAN></TD>
38<TD width="45%">Always register source.</TD>
39    </tr>
40  <tr>
41<TD width="30%"><a href="../../../gx/Lighting/GXSetChanAmbColor.html"><code>GXSetChanAmbColor</code></a></TD>
42<TD width="25%"><SPAN class="argument">Ambient color</SPAN></TD>
43<TD width="45%">Cycles through 6 colors.</TD>
44    </tr>
45  <tr>
46<TD width="30%"><a href="../../../gx/Lighting/GXSetChanMatColor.html"><code>GXSetChanMatColor</code></a></TD>
47<TD width="25%"><SPAN class="argument">Material color</SPAN></TD>
48<TD width="45%">Cycles through 6 colors.</TD>
49    </tr>
50</TABLE>
51
52<h2>Using the Demo</h2>
53<P>The test prints a menu of choices.</P>
54<P>The X/Y buttons navigate up and down in the menu.</P>
55<P>The L and R buttons cycle through states of the current menu item.</P>
56<P>The A button dumps the current state settings.</P>
57<P>START exits the test.</P>
58
59<h2>Snapshot</h2>
60<P>Channel disabled, material = red, ambient = black, and model type is cylinder.</P>
61<P><IMG src="./images/lit-basic-0.jpg" alt="lit-basic-0.jpg (9916 bytes)" width="640" height="480"></p>
62
63<P>Channel enabled. Material = black, ambient = white, and model type is sphere.</P>
64<P><IMG src="./images/lit-basic-1.jpg" alt="lit-basic-1.jpg (6173 bytes)" width="640" height="480"></p>
65
66<P>Channel enabled. Material = green, ambient = gray, and model type is torus.</P>
67<P><IMG src="./images/lit-basic-2.jpg" alt="lit-basic-2.jpg (9631 bytes)" width="640" height="480"></p>
68
69<P>Channel enabled. Material=white, ambient=blue, and model type is icosahedron.</P>
70<P><IMG src="./images/lit-basic-3.jpg" alt="lit-basic-3.jpg (9904 bytes)" width="640" height="480"></p>
71
72<h2>Required Data Files</h2>
73<p>None.</p>
74
75<H2>Revision History</H2>
76<P>
772006/03/01 Initial version.<br>
78</P>
79
80<hr><p>CONFIDENTIAL</p></body>
81</html>