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-spot</title> 10</head> 11 12<body> 13 14<h1 align="left">lit-spot</h1> 15 16 17 18<h2>Description</h2> 19 20<p>This program tests spotlighting with angular attenuation control. A tessellated wall is lit by four lights used in one color channel. You can control the direction and angular attenuation of each light. Furthermore, the attenuation function can be turned on/off. 21</p> 22 23<h2>Coverage</h2> 24<TABLE border="1" cellpadding="3" cellspacing="0.1" width="640"> 25 <tr> 26<TD width="30%" bgcolor="#C0C0C0"><em><strong>Function</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%" valign="top"><a href="../../../gx/Lighting/GXInitLightPos.html"><code>GXInitLightPos</code></a></TD> 32<TD width="25%"><font face="Courier New"><em><strong>Position coordinate (x, y, z)</strong></em></font></TD> 33<TD width="45%">Various values.</TD> 34 </tr> 35 <tr> 36<TD width="30%" valign="top"><a href="../../../gx/Lighting/GXInitLightDir.html"><code>GXInitLightDir</code></a></TD> 37<TD width="25%"><font face="Courier New"><em><strong>Light direction (nx, ny, nz)</strong></em></font></TD> 38<TD width="45%">Various values.</TD> 39 </tr> 40 <tr> 41<TD width="30%" valign="top"><a href="../../../gx/Lighting/GXInitLightColor.html"><code>GXInitLightColor</code></a></TD> 42<TD width="25%"><font face="Courier New"><em><strong>Light color</strong></em></font></TD> 43<TD width="45%">Four colors.</TD> 44 </tr> 45 <tr> 46<TD width="30%" rowspan="2"><a href="../../../gx/Lighting/GXInitLightAttn.html"><code>GXInitLightAttn</code></a></TD> 47<TD width="25%"><font face="Courier New"><em><strong>angle attenuation coefficients</strong></em></font></TD> 48<TD width="45%"><strong>Appropriate value sets.</strong></TD> 49 </tr> 50 <tr> 51<TD width="25%"><font face="Courier New"><em><strong>distance attenuation coefficients</strong></em></font></TD> 52<TD width="45%">Fixed (k0=1, k1=0, k2=0).</TD> 53 </tr> 54 <tr> 55<TD width="30%" valign="top"><a href="../../../gx/Lighting/GXLoadLightObjImm.html"><code>GXLoadLightObjImm</code></a></TD> 56<TD width="25%"><font face="Courier New"><em><strong>Light ID</strong></em></font></TD> 57<TD width="45%"><font face="Courier New">GX_LIGHT0</font> - <font face="Courier New">GX_LIGHT3</font>.</TD> 58 </tr> 59 <tr> 60<TD width="30%" rowspan="7"><a href="../../../gx/Lighting/GXSetChanCtrl.html"><code>GXSetChanCtrl</code></a></TD> 61<TD width="25%"><font face="Courier New"><em><strong>Color channel ID</strong></em></font></TD> 62<TD width="45%">Always <font face="Courier New">GX_COLOR0</font>.</TD> 63 </tr> 64 <tr> 65<TD width="25%"><font face="Courier New"><em><strong>Channel enable</strong></em></font></TD> 66<TD width="45%">Always <font face="Courier New">GX_ENABLE</font>.</TD> 67 </tr> 68 <tr> 69<TD width="25%"><font face="Courier New"><em><strong>Ambient color source</strong></em></font></TD> 70<TD width="45%">Always register source.</TD> 71 </tr> 72 <tr> 73<TD width="25%"><font face="Courier New"><em><strong>Material color source</strong></em></font></TD> 74<TD width="45%">Always register source.</TD> 75 </tr> 76 <tr> 77<TD width="25%"><font face="Courier New"><em><strong>Light mask</strong></em></font></TD> 78<TD width="45%">Some combinations.</TD> 79 </tr> 80 <tr> 81<TD width="25%"><font face="Courier New"><em><strong>Diffusion function</strong></em></font></TD> 82<TD width="45%">Always <font face="Courier New">GX_DF_CLAMP</font>.</TD> 83 </tr> 84 <tr> 85<TD width="25%"><font face="Courier New"><em><strong>Attenuation function</strong></em></font></TD> 86<TD width="45%"><strong><font face="Courier New">GX_AF_SPOT</font></strong> / <strong><font face="Courier New">GX_AF_NONE</font></strong></TD> 87 </tr> 88 <tr> 89<TD width="30%" height="38" rowspan="2"><a href="../../../gx/Lighting/GXSetChanAmbColor.html"><code>GXSetChanAmbColor</code></a></TD> 90<TD width="25%" height="19"><font face="Courier New"><em><strong>Color channel ID</strong></em></font></TD> 91<TD width="45%" height="19">Only <font face="Courier New">GX_COLOR0A0</font>.</TD> 92 </tr> 93 <tr> 94<TD width="25%" height="19"><font face="Courier New"><em><strong>Ambient color</strong></em></font></TD> 95<TD width="45%" height="19">Only one color.</TD> 96 </tr> 97 <tr> 98<TD width="30%" height="38" rowspan="2"><a href="../../../gx/Lighting/GXSetChanMatColor.html"><code>GXSetChanMatColor</code></a></TD> 99<TD width="25%" height="19"><font face="Courier New"><em><strong>Color channel ID</strong></em></font></TD> 100<TD width="45%" height="19">Only <font face="Courier New">GX_COLOR0A0</font>.</TD> 101 </tr> 102 <tr> 103<TD width="25%" height="19"><font face="Courier New"><em><strong>Material color</strong></em></font></TD> 104<TD width="45%" height="19">Only one color.</TD> 105 </tr> 106</TABLE> 107<h2>Operation Method</h2> 108<P>START exits the test.</P> 109<P>The B button selects a light or camera (white light, red light, green light, blue light, camera mode). 110</P> 111<p> <strong><u>Light control mode</u></strong></p> 112<BLOCKQUOTE>The Control Stick controls the direction of the selected light.<br>The C Stick changes the x and y position of the selected light.<br>The L and R Buttons change the z position of selected light.<br>The X and Y Buttons change the spotlight shape (i.e., attenuation parameters) of the selected light.<br>The A Button hides the light position mark.</BLOCKQUOTE> 113<p> <u><strong>Camera control mode</strong></u></p> 114 115<BLOCKQUOTE>The Control Stick moves the camera.<br>The X Button enables spotlight attenuation.<br>The Y Button disables spotlight attenuation.<br>The L and R Buttons change the wall shape.</BLOCKQUOTE> 116<h2>Snapshot</h2> 117 118<P><IMG src="./images/lit-spot.jpg" alt="lit-spot.jpg (7549 bytes)" width="480" height="360"></p> 119 120<h2>Required Data Files</h2> 121 122<p>None.</p> 123<H2>Revision History</H2> 124<P>2006/03/01 Initial version.</P> 125<hr> 126<P>CONFIDENTIAL</p> 127</BODY> 128</HTML>