1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<HTML>
3<HEAD>
4<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
5<META name="GENERATOR" content="Microsoft FrontPage 5.0">
6<META http-equiv="Content-Style-Type" content="text/css">
7<LINK rel="stylesheet" type="text/css" href="../../../CSS/revolution.css">
8<TITLE>tev-multi</TITLE>
9</HEAD>
10<BODY>
11<H1 align="left">tev-multi</H1>
12
13<H2>Description</H2>
14<P>This program tests multiple TEV stages using the re-ordering feature. Processes up to 8 TEV stages. Ordering parameters (for texture maps, texture coordinates, and color channel inputs) and TEV operation modes can be specified in each stage.</P>
15
16<H2>Coverage</H2>
17<TABLE border="1" cellpadding="3" cellspacing="0.1" width="640">
18  <TBODY>
19    <TR>
20<TD width="30%" bgcolor="#C0C0C0"><EM><STRONG>Functions</STRONG></EM></TD>
21<TD width="25%" bgcolor="#C0C0C0"><EM><STRONG>Parameters</STRONG></EM></TD>
22<TD width="45%" bgcolor="#C0C0C0"><EM><STRONG>Description</STRONG></EM></TD>
23    </TR>
24    <TR>
25<TD width="30%" rowspan="5"><A href="../../../gx/Texture/GXInitTexObj.html"><CODE>GXInitTexObj</CODE></A></TD>
26<TD width="25%"><SPAN class="argument">Pointer to image data.</SPAN></TD>
27<TD width="45%">Appropriate value.</TD>
28    </TR>
29    <TR>
30<TD width="25%"><SPAN class="argument">Width and height</SPAN></TD>
31<TD width="45%">Fixed value.</TD>
32    </TR>
33    <TR>
34<TD width="25%"><SPAN class="argument">format</SPAN></TD>
35<TD width="45%"><CODE>GX_TF_RGBA8</CODE></TD>
36    </TR>
37    <TR>
38<TD width="25%"><SPAN class="argument">Wrap mode (s, t).</SPAN></TD>
39<TD width="45%">Always <CODE>GX_REPEAT</CODE>.</TD>
40    </TR>
41    <TR>
42<TD width="25%"><SPAN class="argument">Mipmap</SPAN></TD>
43<TD width="45%">Always <CODE>GX_FALSE</CODE>.</TD>
44    </TR>
45    <TR>
46<TD width="30%"><A href="../../../gx/Texture/GXLoadTexObj.html"><CODE><CODE>GXLoadTexObj</CODE></CODE></A></TD>
47<TD width="25%"><SPAN class="argument">Destination texture name</SPAN></TD>
48<TD width="45%"><STRONG><CODE>GX_TEXMAP0</CODE> - <CODE>GX_TEXMAP7</CODE></STRONG></TD>
49    </TR>
50    <TR>
51<TD width="30%"><A href="../../../gx/Lighting/GXSetNumChans.html"><CODE>GXSetNumChans</CODE></A></TD>
52<TD width="25%"><SPAN class="argument">Number of color channels.</SPAN></TD>
53      <TD width="45%"><STRONG>0, 1, 2</STRONG></TD>
54    </TR>
55    <TR>
56<TD width="30%"><A href="../../../gx/TexCoordGen/GXSetNumTexGens.html"><CODE>GXSetNumTexGens</CODE></A></TD>
57<TD width="25%"><SPAN class="argument">number of texture coordinates.</SPAN></TD>
58      <TD width="45%"><STRONG>0, 8</STRONG></TD>
59    </TR>
60    <TR>
61<TD width="30%" rowspan="4"><CODE><A href="../../../gx/TexCoordGen/GXSetTexCoordGen.html">GXSetTexCoordGen</A></CODE></TD>
62<TD width="25%"><SPAN class="argument">Texture coordinate ID</SPAN></TD>
63<TD width="45%"><STRONG><CODE>GX_TEXCOORD0</CODE> - <CODE>GX_TEXCOORD7</CODE></STRONG></TD>
64    </TR>
65    <TR>
66<TD width="25%"><SPAN class="argument">Type of texture coordinate generation</SPAN></TD>
67<TD width="45%">Always <CODE>GX_TG_MTX2x4</CODE>.</TD>
68    </TR>
69    <TR>
70<TD width="25%"><SPAN class="argument">Source parameter of texture coordinate generation.</SPAN></TD>
71<TD width="45%">Always <CODE>GX_TG_TEX0</CODE>.</TD>
72    </TR>
73    <TR>
74<TD width="25%"><SPAN class="argument">Matrix index</SPAN></TD>
75<TD width="45%">Appropriate matrix index</TD>
76    </TR>
77    <TR>
78<TD width="30%"><A href="../../../gx/Tev/GXSetNumTevStages.html"><CODE><CODE>GXSetNumTevStages</CODE></CODE></A></TD>
79<TD width="25%"><SPAN class="argument">Number of TEV Stages</SPAN></TD>
80      <TD width="45%"><STRONG>1 - 8</STRONG></TD>
81    </TR>
82    <TR>
83<TD width="30%" rowspan="2"><A href="../../../gx/Tev/GXSetTevOp.html"><CODE>GXSetTevOp</CODE></A></TD>
84<TD width="25%"><SPAN class="argument">TEV stage ID.</SPAN></TD>
85<TD width="45%"><STRONG><CODE>GX_TEVSTAGE0</CODE> - <CODE>GX_TEVSTAGE7</CODE></STRONG></TD>
86    </TR>
87    <TR>
88<TD width="25%"><SPAN class="argument">Operation Mode</SPAN></TD>
89<TD width="45%"><STRONG><CODE>GX_PASSCLR</CODE>, <CODE>GX_REPLACE</CODE>, <CODE>GX_DECAL</CODE>, <CODE>GX_MODULATE</CODE>, <CODE>GX_BLEND</CODE></STRONG></TD>
90    </TR>
91    <TR>
92<TD width="30%" rowspan="4"><A href="../../../gx/Tev/GXSetTevOrder.html"><CODE><CODE>GXSetTevOrder</CODE></CODE></A></TD>
93<TD width="25%"><SPAN class="argument">TEV stage ID.</SPAN></TD>
94<TD width="45%"><STRONG><CODE>GX_TEVSTAGE0</CODE> - <CODE>GX_TEVSTAGE7</CODE>,</STRONG></TD>
95    </TR>
96    <TR>
97<TD width="25%"><SPAN class="argument">Texture coordinate ID</SPAN></TD>
98<TD width="45%"><STRONG><CODE>GX_TEXCOORD0</CODE> - <CODE>GX_TEXCOORD7</CODE>, <CODE>GX_TEXCOORD_NULL</CODE></STRONG></TD>
99    </TR>
100    <TR>
101<TD width="25%"><SPAN class="argument">Texture map ID</SPAN></TD>
102<TD width="45%"><STRONG><CODE>GX_TEXMAP0</CODE> - <CODE>GX_TEXMAP7</CODE>, <CODE>GX_TEXMAP_NULL</CODE></STRONG></TD>
103    </TR>
104    <TR>
105<TD width="25%"><SPAN class="argument">Color channel ID</SPAN></TD>
106<TD width="45%"><STRONG><CODE>GX_COLOR0A0</CODE>, <CODE>GX_COLOR1A1</CODE>, <CODE>GX_COLOR_NULL</CODE></STRONG></TD>
107    </TR>
108  </TBODY>
109</TABLE>
110
111<H2>Method of Operation</H2>
112<P>End the test with START.</P>
113<P>The Control Stick moves the cursor.</P>
114<P>The X and Y Buttons change the parameter value pointed to by the cursor.</P>
115<P>The A Button stops the animation.</P>
116<P>The B Button changes the channel color.</P>
117
118<H2>Snapshot</H2>
119<P>Eight-layered texture using the <CODE>GX_DECAL</CODE> mode.</P>
120<P><IMG src="./images/tev-multi-0.jpg" alt="tev-multi-0.jpg (58194 bytes)" width="640" height="480"></P>
121<P><CODE>GX_PASSCLR</CODE> and <CODE>GX_REPLACE</CODE>.</P>
122<P><IMG src="./images/tev-multi-1.jpg" alt="tev-multi-1.jpg (48172 bytes)" width="640" height="480"></P>
123<P><CODE>GX_BLEND</CODE> and <CODE>GX_MODULATE</CODE>.</P>
124<P><IMG src="./images/tev-multi-2.jpg" alt="tev-multi-2.jpg (54517 bytes)" width="640" height="480"></P>
125<P>Random ordering</P>
126<P><IMG src="./images/tev-multi-3.jpg" alt="tev-multi-3.jpg (54915 bytes)" width="640" height="480"></P>
127
128<H2>Required Data Files</H2>
129<P><CODE>$REVOLUTION_SDK_ROOT/dvddata/gxTests/tev-02.tpl</CODE></P>
130
131<H2>Revision History</H2>
132<P>
1332008/07/22 Added information to <B>Method of Operation</B>.<br>2006/03/01 Initial version.<br>
134</P>
135
136<hr><p>CONFIDENTIAL</p></body>
137</HTML>