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-prelit</title> 10</head> 11 12<body> 13 14<h1 align="left">lit-prelit</h1> 15 16 17 18<h2>Description</h2> 19 20<P>This program performs a prelighting test. In this test, the software calculates the prelit color for each vertex. The prelit color functions as the ambient color of the RGB color channel when the color of hardware lights is added.</P> 21<h2>Coverage</h2> 22 23<p>This program also tests any combination of material/ambient source settings. 24</p> 25<TABLE border="1" cellpadding="3" cellspacing="0.1" width="640"> 26 <tr> 27<TD width="30%" bgcolor="#C0C0C0"><em><strong>Function</strong></em></TD> 28<TD width="25%" bgcolor="#C0C0C0"><em><strong>Parameters</strong></em></TD> 29<TD width="45%" bgcolor="#C0C0C0"><em><strong>Description</strong></em></TD> 30 </tr> 31 <tr> 32<TD width="30%"><a href="../../../gx/Lighting/GXInitLightDir.html"><code>GXInitLightDir</code></a></TD> 33<TD width="25%"><em><strong><font face="Courier New">Light direction (nx, ny, nz)</font></strong></em></TD> 34<TD width="45%">Various values.</TD> 35 </tr> 36 <tr> 37<TD width="30%" rowspan="7"><a href="../../../gx/Lighting/GXSetChanCtrl.html"><code>GXSetChanCtrl</code></a></TD> 38<TD width="25%"><em><strong><font face="Courier New">Color channel ID</font></strong></em></TD> 39<TD width="45%">Always <font face="Courier New">GX_COLOR0</font>.</TD> 40 </tr> 41 <tr> 42<TD width="25%"><em><strong><font face="Courier New">Channel enable</font></strong></em></TD> 43<TD width="45%">Always <font face="Courier New">GX_ENABLE</font>.</TD> 44 </tr> 45 <tr> 46<TD width="25%"><em><strong><font face="Courier New">Ambient color source</font></strong></em></TD> 47<TD width="45%"><strong><font face="Courier New">GX_SRC_VTX</font></strong> / <strong><font face="Courier New">GX_SRC_REG</font></strong>.</TD> 48 </tr> 49 <tr> 50<TD width="25%"><em><strong><font face="Courier New">Material color source</font></strong></em></TD> 51<TD width="45%"><font face="Courier New"><strong>GX_SRC_VTX</strong></font> / <font face="Courier New"><strong>GX_SRC_REG</strong></font>.</TD> 52 </tr> 53 <tr> 54<TD width="25%"><em><strong><font face="Courier New">Light mask</font></strong></em></TD> 55<TD width="45%">Always enables all four lights.</TD> 56 </tr> 57 <tr> 58<TD width="25%"><em><strong><font face="Courier New">Diffusion function</font></strong></em></TD> 59<TD width="45%">Always <font face="Courier New">GX_DF_CLAMP</font>.</TD> 60 </tr> 61 <tr> 62<TD width="25%"><em><strong><font face="Courier New">Attenuation function</font></strong></em></TD> 63<TD width="45%">Always <font face="Courier New">GX_AF_SPOT</font>.</TD> 64 </tr> 65 <tr> 66<TD width="30%"><a href="../../../gx/Lighting/GXSetChanAmbColor.html"><code>GXSetChanAmbColor</code></a></TD> 67<TD width="25%"><em><strong><font face="Courier New">Ambient color</font></strong></em></TD> 68<TD width="45%">Only one color.</TD> 69 </tr> 70 <tr> 71<TD width="30%"><a href="../../../gx/Lighting/GXSetChanMatColor.html"><code>GXSetChanMatColor</code></a></TD> 72<TD width="25%"><em><strong><font face="Courier New">Material color</font></strong></em></TD> 73<TD width="45%">Only one color.</TD> 74 </tr> 75</TABLE> 76<h2>Operation Method</h2> 77<P>START exits the test.</P> 78<P>The A Button changes the material/ambient source settings. Four combination patterns are shown in turn. 79</P> 80<h2>Snapshot</h2> 81 82<p>Prelit color is not used. Both material and ambient sources are registers. 83</p> 84 85<P><IMG src="./images/lit-prelit-0.jpg" alt="lit-prelit-0.jpg (3203 bytes)" width="320" height="240"></p> 86 87 88<p>Prelit color is used as ambient. Material source is register. </p> 89<P><IMG src="./images/lit-prelit-1.jpg" alt="lit-prelit-1.jpg (4767 bytes)" width="320" height="240"></P> 90<p>Prelit color is used as material. Ambient source is register. </p> 91<P><IMG src="./images/lit-prelit-2.jpg" alt="lit-prelit-2.jpg (3195 bytes)" width="320" height="240"></P> 92<p>Prelit color is used as both material and ambient.</p> 93<P><IMG src="./images/lit-prelit-3.jpg" alt="lit-prelit-3.jpg (4262 bytes)" width="320" height="240"></P> 94<h2>Required Data Files</h2> 95 96<p>None.</p> 97<H2>Revision History</H2> 98<P>2006/03/01 Initial version.</P> 99<hr> 100<P>CONFIDENTIAL</p> 101</BODY> 102</HTML>
