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<LINK rel="stylesheet" type="text/css" href="../../../CSS/revolution.css">
10<title>frb-copy</title>
11</head>
12
13<body>
14
15<h1 align="left">frb-copy</h1>
16
17<h2>Description</h2>
18<P>This program tests texture copying from the frame buffer. There is a capture window on the screen; the image inside the window is copied into the texture buffer. The copied texture is mapped on a panel by the next frame. The size of the capture window and the texture format can both be changed. Two options for the texture copy API (mipmap filter and clear) can be also controlled.</P>
19
20<h2>Coverage</h2>
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%"><a href="../../../gx/Framebuffer/GXSetTexCopySrc.html"><code>GXSetTexCopySrc</code></a></TD>
29<TD width="25%"><SPAN class="argument">Top / left / width / height</SPAN></TD>
30<TD width="45%">Various values.</TD>
31    </tr>
32  <tr>
33<TD width="30%" rowspan="3"><a href="../../../gx/Framebuffer/GXSetDispCopyDst.html"><code>GXSetTexCopyDst</code></a></TD>
34<TD width="25%"><SPAN class="argument">Width and height</SPAN></TD>
35<TD width="45%">Various values.</TD>
36    </tr>
37  <tr>
38<TD width="25%"><SPAN class="argument">Format</SPAN></TD>
39<TD width="45%" valign="top"><CODE>GX_TF_I4</CODE>, <CODE>GX_TF_I8</CODE>, <CODE>GX_TF_IA4</CODE>, <CODE>GX_TF_IA8</CODE>, <CODE>GX_TF_RGB565</CODE>, <CODE>GX_TF_RGB5A3</CODE>, <CODE>GX_TF_RGBA8</CODE>, <CODE>GX_TF_A8</CODE>.</TD>
40    </tr>
41  <tr>
42<TD width="25%"><SPAN class="argument">Mipmap filter</SPAN></TD>
43<TD width="45%"><CODE>GX_TRUE</CODE> / <CODE>GX_FALSE</CODE></TD>
44    </tr>
45  <tr>
46<TD width="30%" rowspan="2"><a href="../../../gx/Framebuffer/GXCopyTex.html"><code>GXCopyTex</code></a></TD>
47<TD width="25%"><SPAN class="argument">Image pointer</SPAN></TD>
48<TD width="45%">Appropriate value.</TD>
49    </tr>
50  <tr>
51<TD width="25%"><SPAN class="argument">Clear operation</SPAN></TD>
52<TD width="45%"><CODE>GX_TRUE</CODE> / <CODE>GX_FALSE</CODE></TD>
53    </tr>
54  <tr>
55<TD width="30%" rowspan="2"><a href="../../../gx/Framebuffer/GXSetCopyClear.html"><code>GXSetCopyClear</code></a></TD>
56<TD width="25%"><SPAN class="argument">Color</SPAN></TD>
57<TD width="45%">Only one color.</TD>
58    </tr>
59  <tr>
60<TD width="25%"><SPAN class="argument">Z value</SPAN></TD>
61<TD width="45%">Always 0xFFFFFF.</TD>
62    </tr>
63  <tr>
64<TD width="30%" rowspan="5"><a href="../../../gx/Texture/GXInitTexObj.html"><code>GXInitTexObj</code></a></TD>
65<TD width="25%"><SPAN class="argument">Image pointer</SPAN></TD>
66<TD width="45%">Appropriate value.</TD>
67    </tr>
68  <tr>
69<TD width="25%"><SPAN class="argument">Width and height</SPAN></TD>
70<TD width="45%">Various values.</TD>
71    </tr>
72  <tr>
73<TD width="25%"><SPAN class="argument">Format</SPAN></TD>
74<TD width="45%"><CODE>GX_TF_I4</CODE>, <CODE>GX_TF_I8</CODE>, <CODE>GX_TF_IA4</CODE>, <CODE>GX_TF_IA8</CODE>, <CODE>GX_TF_RGB565</CODE>, <CODE>GX_TF_RGB5A3</CODE>, <CODE>GX_TF_RGBA8</CODE>, <CODE>GX_TF_A8</CODE>.</TD>
75    </tr>
76  <tr>
77<TD width="25%"><SPAN class="argument">Wrap mode (s, t)</SPAN></TD>
78<TD width="45%"><CODE>GX_CLAMP</CODE>, <CODE>GX_REPEAT</CODE>.</TD>
79    </tr>
80  <tr>
81<TD width="25%"><SPAN class="argument">Mipmap</SPAN></TD>
82<TD width="45%">Always <CODE>GX_FALSE</CODE>.</TD>
83    </tr>
84  <tr>
85<TD width="30%"><a href="../../../gx/Texture/GXLoadTexObj.html"><code>GXLoadTexObj</code></a></TD>
86<TD width="25%"><SPAN class="argument">Destination texture name</SPAN></TD>
87<TD width="45%">Always <CODE>GX_TEXMAP0</CODE>.</TD>
88    </tr>
89  <tr>
90<TD width="30%" rowspan="4"><a href="../../../gx/Texture/GXGetTexBufferSize.html"><code>GXGetTexBufferSize</code></a></TD>
91<TD width="25%" valign="top"><SPAN class="argument">Width and height</SPAN></TD>
92<TD valign="top" width="45%">Various values.</TD>
93    </tr>
94  <tr>
95<TD width="25%"><SPAN class="argument">Format</SPAN></TD>
96<TD valign="top" width="45%"><CODE>GX_TF_I4</CODE>, <CODE>GX_TF_I8</CODE>, <CODE>GX_TF_IA4</CODE>, <CODE>GX_TF_IA8</CODE>, <CODE>GX_TF_RGB565</CODE>, <CODE>GX_TF_RGB5A3</CODE>, <CODE>GX_TF_RGBA8</CODE>, <CODE>GX_TF_A8</CODE>.</TD>
97    </tr>
98  <tr>
99<TD valign="top" width="25%"><SPAN class="argument">Mipmap</SPAN></TD>
100<TD valign="top" width="45%">Always <CODE>GX_FALSE</CODE>.</TD>
101    </tr>
102  <tr>
103<TD width="25%"><SPAN class="argument">Max LOD</SPAN></TD>
104<TD valign="top" width="45%">N/A</TD>
105    </tr>
106  <tr>
107<TD width="30%"><a href="../../../gx/Texture/GXInvalidateTexAll.html"><code>GXInvalidateTexAll</code></a></TD>
108<TD width="25%"><SPAN class="argument">(No parameter)</SPAN></TD>
109      <TD width="45%"> </TD>
110    </tr>
111  <tr>
112<TD width="30%" rowspan="2"><a href="../../../gx/Tev/GXSetTevOp.html"><code>GXSetTevOp</code></a></TD>
113<TD width="25%"><SPAN class="argument">TEV stage ID</SPAN></TD>
114<TD width="45%">Always <CODE>GX_TEVSTAGE0</CODE>.</TD>
115    </tr>
116  <tr>
117<TD width="25%"><SPAN class="argument">Operation mode</SPAN></TD>
118<TD width="45%"><CODE>GX_PASSCLR</CODE>, <CODE>GX_DECAL</CODE>, <CODE>GX_REPLACE</CODE>.</TD>
119    </tr>
120</TABLE>
121
122<h2>Using the Demo</h2>
123<P>PAUSE exits the test.</P>
124<P>The Control Stick moves the capture window.</P>
125<p>A Button changes the texture format.</p>
126
127<p>C stick changes the size of the window.</p>
128<P>L and R Buttons move the camera.</P>
129<P>Y button turns the mipmap (box) filter option ON/OFF.</P>
130<P>X Button turns the clear frame buffer option ON/OFF.</P>
131<P>B button changes the texture format for copying.</P>
132
133<h2>Snapshot</h2>
134<p>RGB565 format, mipmap filter=OFF, clear option=OFF.</p>
135<P><IMG src="./images/frb-copy-0.jpg" alt="frb-copy-0.jpg (52768 bytes)" width="640" height="480"></p>
136
137<p>I4 format, mipmap filter=OFF, clear option=OFF.</p>
138<P><IMG src="./images/frb-copy-3.jpg" alt="frb-copy-3.jpg (50045 bytes)" width="640" height="480"></p>
139
140<P>A8 format, mipmap filter=OFF, clear option=OFF.</P>
141<P><IMG src="./images/frb-copy-7.jpg" alt="frb-copy-7.jpg (46597 bytes)" width="640" height="480"></p>
142
143<p>RGBA8 format, mipmap filter=ON, clear option=OFF.</p>
144<P><IMG src="./images/frb-copy-10.jpg" alt="frb-copy-9.jpg (46004 bytes)" width="640" height="480"></p>
145
146<p>IA8 format, mipmap filter=OFF, clear option=ON</p>
147<P><IMG src="./images/frb-copy-22.jpg" alt="frb-copy-20.jpg (52513 bytes)" width="640" height="480"></P>
148
149<h2>Required Data Files</h2>
150<p>None.</p>
151
152<H2>Revision History</H2>
153<P>
1542006/03/01 Initial version.<br>
155</P>
156
157<hr><p>CONFIDENTIAL</p></body>
158</html>