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