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-atn-func</title> 10</head> 11 12<body> 13 14<h1 align="left">lit-atn-func</h1> 15 16 17 18<h2>Description</h2> 19 20<P>This program tests two light attenuation functions. There are two subtests in this program: angular attenuation mode and distance attenuation mode. 21</P> 22<h2>Coverage</h2> 23<TABLE border="1" cellpadding="3" cellspacing="0.1" width="640"> 24 <tr> 25<TD width="30%" bgcolor="#C0C0C0"><em><strong>Function</strong></em></TD> 26<TD width="25%" bgcolor="#C0C0C0"><em><strong>Parameters</strong></em></TD> 27<TD width="45%" bgcolor="#C0C0C0"><em><strong>Description</strong></em></TD> 28 </tr> 29 <tr> 30<TD width="30%" rowspan="2"><a href="../../../gx/Lighting/GXInitLightSpot.html"><code>GXInitLightSpot</code></a></TD> 31<TD width="25%"><font face="Courier New"><em><strong>Cutoff angle.</strong></em></font></TD> 32<TD width="45%">Various values.</TD> 33 </tr> 34 <tr> 35<TD width="25%"><font face="Courier New"><em><strong>Spot function</strong></em></font></TD> 36<TD width="45%"><font face="Courier New">GX_SP_OFF</font>, <font face="Courier New">GX_SP_FLAT</font>, <font face="Courier New">GX_SP_COS</font>, <font face="Courier New">GX_SP_COS2</font>, <font face="Courier New">GX_SP_SHARP</font>, <font face="Courier New">GX_SP_RING1</font>, <font face="Courier New">GX_SP_RING2</font>.</TD> 37 </tr> 38 <tr> 39<TD width="30%" rowspan="3"><a href="../../../gx/Lighting/GXInitLightDistAttn.html"><code>GXInitLightDistAttn</code></a></TD> 40<TD width="25%"><font face="Courier New"><em><strong>Light reference distance</strong></em></font></TD> 41<TD width="45%">Always <font face="Courier New">GX_TEVSTAGE0</font>.</TD> 42 </tr> 43 <tr> 44<TD width="25%"><font face="Courier New"><em><strong>Reference brightness</strong></em></font></TD> 45<TD width="45%"><font face="Courier New">GX_MODULATE, GX_REPLACE</font>.</TD> 46 </tr> 47 <tr> 48<TD width="25%"><font face="Courier New"><em><strong>Distance attenuation function</strong></em></font></TD> 49<TD width="45%"><font face="Courier New">GX_DA_OFF</font>, <font face="Courier New">GX_DA_GENTLE</font>, <font face="Courier New">GX_DA_MEDIUM</font>, <font face="Courier New">GX_DA_STEEP</font>.</TD> 50 </tr> 51 <tr> 52<TD width="30%" rowspan="7"><a href="../../../gx/Lighting/GXSetChanCtrl.html"><code>GXSetChanCtrl</code></a></TD> 53<TD width="25%"><font face="Courier New"><em><strong>Color channel ID</strong></em></font></TD> 54<TD width="45%">Always <font face="Courier New">GX_COLOR0</font>.</TD> 55 </tr> 56 <tr> 57<TD width="25%"><font face="Courier New"><em><strong>Channel enable</strong></em></font></TD> 58<TD width="45%">Always <font face="Courier New">GX_ENABLE</font>.</TD> 59 </tr> 60 <tr> 61<TD width="25%"><font face="Courier New"><em><strong>Ambient color source</strong></em></font></TD> 62<TD width="45%">Always register source.</TD> 63 </tr> 64 <tr> 65<TD width="25%"><font face="Courier New"><em><strong>Material color source</strong></em></font></TD> 66<TD width="45%">Always register source.</TD> 67 </tr> 68 <tr> 69<TD width="25%"><font face="Courier New"><em><strong>Light mask</strong></em></font></TD> 70<TD width="45%"><font face="Courier New">GX_LIGHT0</font> for Color0 channel.<br> <font face="Courier New">GX_LIGHT1</font> for Alpha0 channel.</TD> 71 </tr> 72 <tr> 73<TD width="25%"><font face="Courier New"><em><strong>Diffusion function</strong></em></font></TD> 74<TD width="45%">Always <font face="Courier New">GX_DF_CLAMP</font>.</TD> 75 </tr> 76 <tr> 77<TD width="25%"><font face="Courier New"><em><strong>Attenuation function</strong></em></font></TD> 78<TD width="45%">Always <font face="Courier New">GX_AF_SPOT</font>.</TD> 79 </tr> 80 <tr> 81<TD width="30%"><a href="../../../gx/Lighting/GXSetChanAmbColor.html"><code>GXSetChanAmbColor</code></a></TD> 82<TD width="25%"><font face="Courier New"><em><strong>Ambient color</strong></em></font></TD> 83<TD width="45%">Only one value.</TD> 84 </tr> 85 <tr> 86<TD width="30%"><a href="../../../gx/Lighting/GXSetChanMatColor.html"><code>GXSetChanMatColor</code></a></TD> 87<TD width="25%"><font face="Courier New"><em><strong>Material color</strong></em></font></TD> 88<TD width="45%">Only one value.</TD> 89 </tr> 90 <tr> 91<TD width="30%" rowspan="2"><a href="../../../gx/Tev/GXSetTevOp.html"><code>GXSetTevOp</code></a></TD> 92<TD width="25%"><font face="Courier New"><em><strong>TEV stage ID</strong></em></font></TD> 93<TD width="45%">Always <font face="Courier New">GX_TEVSTAGE0</font>.</TD> 94 </tr> 95 <tr> 96<TD width="25%"><font face="Courier New"><em><strong>Mode</strong></em></font></TD> 97<TD width="45%">Always <font face="Courier New">GX_MODULATE</font>.</TD> 98 </tr> 99</TABLE> 100<h2>Operation Method</h2> 101 102<P>START exits the test.<br></P> 103<P>The B Button toggles between the angular and distance test. 104</P> 105<p> <u><strong>Angular (Spot) Attenuation Test</strong></u></p> 106<BLOCKQUOTE>The X and Y Buttons change the spot function type.<br>The Controller Stick (left/right) changes the cutoff angle. 107</BLOCKQUOTE> 108<p> <u><strong>Distance Attenuation Test</strong></u></p> 109<BLOCKQUOTE>The X and Y Buttons change the distance attenuation function type.<br>The Control Stick (left/right) changes the reference distance.<br>The Control Stick (up/down) changes the reference brightness. 110</BLOCKQUOTE> 111<h2>Snapshot</h2> 112 113<p><em>Example</em></p> 114 115<table border="0" width="55%" cellspacing="0" cellpadding="0"> 116 <tr> 117<td width="22%">Anglular, <code>GX_SP_FLAT</code>.</td> 118<td width="21%">Angular, <code>GX_SP_COS2</code></td> 119 </tr> 120 <tr> 121 <td width="22%" align="center"> 122<img src="./images/lit-atn-func-1.jpg" alt="lit-atn-func-1.jpg (7903 bytes)" width="320" height="240"></td> 123 <td width="21%"> 124<img src="./images/lit-atn-func-3.jpg" alt="lit-atn-func-3.jpg (6237 bytes)" width="320" height="240"></td> 125 </tr> 126 <tr> 127 <td width="22%" align="center"></td> 128 <td width="21%"></td> 129 </tr> 130 <tr> 131<TD width="22%">Distance, <code>GX_DA_GENTLE</code></td> 132<td width="21%">Distance, <code>GX_DA_STEEP</code></td> 133 </tr> 134 <tr> 135 <td width="22%" align="center"> 136<img src="./images/lit-atn-func-8.jpg" alt="lit-atn-func-8.jpg (3679 bytes)" width="320" height="240"></td> 137 <td width="21%"> 138<img src="./images/lit-atn-func-10.jpg" alt="lit-atn-func-10.jpg (4022 bytes)" width="320" height="240"></td> 139 </tr> 140</table> 141 142<h2>Required Data Files</h2> 143 144<p><font face="Courier New">$REVOLUTION_SDK_ROOT/dvddata/gxTests/lit-10.tpl</font>.</p> 145<H2>Revision History</H2> 146<P>2006/03/01 Initial version.</P> 147<hr> 148<P>CONFIDENTIAL</p> 149</BODY> 150</HTML>
