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>GX State Issues</TITLE> 9</HEAD> 10<BODY> 11<H1 align="left">GX State Issues</H1> 12<H2>State Issuing vs. the Display List</H2> 13<P>In this document we describe the following items:</P> 14<UL> 15<LI>The GX functions that affect the same GP registers 16<LI>The GX functions that leave a state pending 17<LI>The GX functions that flush all pending states 18<LI>Types of registers affected by each GX function 19</UL> 20<P>This information can be used for various purposes, such as constructing display lists and optimizing function call patterns.</P> 21<P>The following register types are shown in the tables below.</P> 22<TABLE border="1" cellpadding="3" cellspacing="0"> 23 <TBODY> 24 <TR> 25<TD width="103"><B>Register Type</B></TD> 26<TD width="252"><B>Description</B></TD> 27 </TR> 28 <TR> 29<TD>CP</TD> 30<TD>Command Processor.</TD> 31 </TR> 32 <TR> 33<TD>XF</TD> 34<TD>Transform unit.</TD> 35 </TR> 36 <TR> 37<TD>RS</TD> 38<TD>Raster pipe state.</TD> 39 </TR> 40 </TBODY> 41</TABLE> 42<P><STRONG>Note: </STRONG> In the Revolution SDK, GX Library issues commands in a different order than in the GAMECUBE SDK; this serves to improve the internal processing efficiency of the graphics processor. Specifically, most states due to the XF command will be delayed (apart from a few exceptions, such as loading a matrix).</P> 43<H2>Well-Behaved GX Functions</H2> 44<P>We begin by describing the <EM>well-behaved</EM> GX functions. These functions each affect unique registers, and they insert their command tokens immediately (leaving no pending state). They are easy to put into display lists. </P> 45<TABLE border="1" cellpadding="3" cellspacing="0"> 46 <TBODY> 47 <TR> 48<TD width="411"><B>Functions</B></TD> 49<TD width="119"><B>Register Type</B></TD> 50 </TR> 51 <TR> 52<TD><A href="Geometry/GXSetArray.html"><CODE><CODE>GXSetArray</CODE></CODE></A></TD> 53<TD>CP</TD> 54 </TR> 55 <TR> 56<TD><A href="Geometry/GXInvalidateVtxCache.html"><CODE>GXInvalidateVtxCache</CODE></A></TD> 57<TD>CP</TD> 58 </TR> 59 <TR> 60 <TD> </TD> 61 <TD> </TD> 62 </TR> 63 <TR> 64 <TD><A href="Transform/GXLoadPosMtxImm.html"><CODE>GXLoadPosMtxImm</CODE></A> / <A href="Transform/GXLoadPosMtxIndx.html"><CODE>Indx</CODE></A></TD> 65 <TD>XF</TD> 66 </TR> 67 <TR> 68 <TD><A href="Transform/GXLoadNrmMtxImm.html"><CODE>GXLoadNrmMtxImm</CODE></A> / <CODE><A href="Transform/GXLoadNrmMtxImm3x3.html">Imm3x3</A></CODE> / <CODE><A href="Transform/GXLoadNrmMtxIndx3x3.html">Indx3x3</A></CODE></TD> 69 <TD>XF</TD> 70 </TR> 71 <TR> 72 <TD><A href="Transform/GXLoadTexMtxImm.html"><CODE>GXLoadTexMtxImm</CODE></A> / <A href="Transform/GXLoadTexMtxIndx.html"><CODE>Indx</CODE></A></TD> 73 <TD>XF</TD> 74 </TR> 75 <TR> 76 <TD><A href="Culling/GXSetClipMode.html"><CODE>GXSetClipMode</CODE></A></TD> 77 <TD>XF</TD> 78 </TR> 79 <TR> 80 <TD> </TD> 81 <TD> </TD> 82 </TR> 83 <TR> 84 <TD><A href="Lighting/GXLoadLightObjImm.html"><CODE>GXLoadLightObjImm</CODE></A></TD> 85 <TD>XF</TD> 86 </TR> 87 <TR> 88 <TD><A href="Lighting/GXLoadLightObjIndx.html"><CODE>GXLoadLightObjIndx</CODE></A></TD> 89 <TD>XF</TD> 90 </TR> 91 <TR> 92 <TD> </TD> 93 <TD> </TD> 94 </TR> 95 <TR> 96<TD><A href="Indirect/GXSetTevIndirect.html"><CODE>GXSetTevInd*</CODE></A> (all the various functions to set indirect modes)</TD> 97<TD>RS</TD> 98 </TR> 99 <TR> 100 <TD><A href="Indirect/GXSetTevDirect.html"><CODE>GXSetTevDirect</CODE></A></TD> 101 <TD>RS</TD> 102 </TR> 103 <TR> 104<TD><A href="Indirect/GXSetIndTexMtx.html"><CODE><CODE>GXSetIndTexMtx</CODE></CODE></A></TD> 105<TD>RS</TD> 106 </TR> 107 <TR> 108 <TD> </TD> 109 <TD> </TD> 110 </TR> 111 <TR> 112 <TD><A href="Management/GXPixModeSync.html"><CODE>GXPixModeSync</CODE></A></TD> 113 <TD>RS</TD> 114 </TR> 115 <TR> 116 <TD><A href="Management/GXTexModeSync.html"><CODE>GXTexModeSync</CODE></A></TD> 117 <TD>RS</TD> 118 </TR> 119 <TR> 120 <TD><A href="Management/GXSetDrawSync.html"><CODE>GXSetDrawSync</CODE></A></TD> 121 <TD>RS</TD> 122 </TR> 123 <TR> 124 <TD> </TD> 125 <TD> </TD> 126 </TR> 127 <TR> 128 <TD><A href="Framebuffer/GXSetCopyClear.html"><CODE>GXSetCopyClear</CODE></A></TD> 129 <TD>RS</TD> 130 </TR> 131 <TR> 132 <TD><A href="Framebuffer/GXSetCopyFilter.html"><CODE>GXSetCopyFilter</CODE></A></TD> 133 <TD>RS</TD> 134 </TR> 135 <TR> 136 <TD><A href="Framebuffer/GXClearBoundingBox.html"><CODE>GXClearBoundingBox</CODE></A></TD> 137 <TD>RS</TD> 138 </TR> 139 <TR> 140<TD><A href="PixelProc/GXSetZMode.html"><CODE><CODE>GXSetZMode</CODE></CODE></A></TD> 141<TD>RS</TD> 142 </TR> 143 <TR> 144 <TD><A href="PixelProc/GXSetDstAlpha.html"><CODE>GXSetDstAlpha</CODE></A></TD> 145 <TD>RS</TD> 146 </TR> 147 <TR> 148 <TD><A href="PixelProc/GXSetFieldMask.html"><CODE>GXSetFieldMask</CODE></A></TD> 149 <TD>RS</TD> 150 </TR> 151 <TR> 152 <TD><A href="Culling/GXSetScissor.html"><CODE>GXSetScissor</CODE></A></TD> 153 <TD>RS</TD> 154 </TR> 155 <TR> 156 <TD><A href="Culling/GXSetScissorBoxOffset.html"><CODE>GXSetScissorBoxOffset</CODE></A></TD> 157 <TD>RS</TD> 158 </TR> 159 <TR> 160 <TD> </TD> 161 <TD> </TD> 162 </TR> 163 <TR> 164<TD><A href="Tev/GXSetTevColor.html"><CODE><CODE>GXSetTevColor</CODE></CODE></A></TD> 165<TD>RS</TD> 166 </TR> 167 <TR> 168<TD><A href="Tev/GXSetTevColorS10.html"><CODE>GXSetTevColorS10</CODE></A></TD> 169<TD>RS</TD> 170 </TR> 171 <TR> 172<TD><A href="Tev/GXSetTevKColor.html"><CODE><CODE>GXSetTevKColor</CODE></CODE></A></TD> 173<TD>RS</TD> 174 </TR> 175 <TR> 176<TD><A href="Tev/GXSetAlphaCompare.html"><CODE><CODE>GXSetAlphaCompare</CODE></CODE></A></TD> 177<TD>RS</TD> 178 </TR> 179 <TR> 180 <TD><A href="Tev/GXSetZTexture.html"><CODE>GXSetZTexture</CODE></A></TD> 181 <TD>RS</TD> 182 </TR> 183 <TR> 184 <TD><A href="PixelProc/GXSetFog.html"><CODE>GXSetFog</CODE></A></TD> 185 <TD>RS</TD> 186 </TR> 187 <TR> 188 <TD><A href="PixelProc/GXSetFogRangeAdj.html"><CODE>GXSetFogRangeAdj</CODE></A></TD> 189 <TD>RS</TD> 190 </TR> 191 </TBODY> 192</TABLE> 193 194<H2>Functions with Register Conflicts</H2> 195<P>These functions conflict with others that use the same register(s). They can be put into display lists carefully as long as you understand that doing so will affect all settings sharing the same registers. <BR><BR><B>Note:</B> Some of the register conflicts are also listed in the next section.<br></P> 196<P>It is possible to work around any RS register conflict (it is not possible for CP or XF register conflicts). There is a mask register that can be used to write only certain bits within a RS register. Given that it takes time to set the mask register, none of the current GX functions use this feature. The one exception is the <A href="Culling/GXSetCoPlanar.html"><CODE>GXSetCoPlanar</CODE></A> function (which would otherwise conflict with the <EM>genmode</EM> register). Future revisions of GX may include functions that utilize the mask register. If you think you can greatly benefit from using the mask register, please contact Developer Support with your reasons.<br></P> 197<TABLE border="1" cellpadding="3" cellspacing="0"> 198 <TBODY> 199 <TR> 200<TD width="205"><B>Functions</B></TD> 201<TD width="330"><B>Shared Register Name</B></TD> 202<TD width="94"><B>Register Type</B></TD> 203 </TR> 204 <TR> 205<TD><A href="PixelProc/GXSetBlendMode.html"><CODE><CODE>GXSetBlendMode</CODE></CODE></A></TD> 206<TD><EM>cmode0</EM></TD> 207<TD>RS</TD> 208 </TR> 209 <TR> 210 <TD><A href="PixelProc/GXSetColorUpdate.html"><CODE>GXSetColorUpdate</CODE></A></TD> 211 <TD><EM>cmode0</EM></TD> 212 <TD>RS</TD> 213 </TR> 214 <TR> 215 <TD><A href="PixelProc/GXSetAlphaUpdate.html"><CODE>GXSetAlphaUpdate</CODE></A></TD> 216 <TD><EM>cmode0</EM></TD> 217 <TD>RS</TD> 218 </TR> 219 <TR> 220 <TD><A href="PixelProc/GXSetDither.html"><CODE>GXSetDither</CODE></A></TD> 221 <TD><EM>cmode0</EM></TD> 222 <TD>RS</TD> 223 </TR> 224 <TR> 225 <TD> </TD> 226 <TD> </TD> 227 <TD> </TD> 228 </TR> 229 <TR> 230<TD><A href="PixelProc/GXSetZCompLoc.html"><CODE><CODE>GXSetZCompLoc</CODE></CODE></A></TD> 231<TD><EM>peCtrl</EM></TD> 232<TD>RS</TD> 233 </TR> 234 <TR> 235 <TD><A href="PixelProc/GXSetPixelFmt.html"><CODE>GXSetPixelFmt</CODE></A></TD> 236 <TD><EM>peCtrl</EM></TD> 237 <TD>RS</TD> 238 </TR> 239 <TR> 240 <TD> </TD> 241 <TD> </TD> 242 <TD> </TD> 243 </TR> 244 <TR> 245<TD><A href="Tev/GXSetTevOp.html"><CODE>GXSetTevOp</CODE></A></TD> 246<TD>(invokes the following four functions)</TD> 247<TD>RS</TD> 248 </TR> 249 <TR> 250<TD><A href="Tev/GXSetTevColorIn.html"><CODE><CODE>GXSetTevColorIn</CODE></CODE></A></TD> 251<TD>(shares register with TevColorOp[stage])</TD> 252<TD>RS</TD> 253 </TR> 254 <TR> 255<TD><A href="Tev/GXSetTevAlphaIn.html"><CODE><CODE>GXSetTevAlphaIn</CODE></CODE></A></TD> 256<TD>(shares register with TevAlphaOp[stage])</TD> 257<TD>RS</TD> 258 </TR> 259 <TR> 260<TD><A href="Tev/GXSetTevColorOp.html"><CODE><CODE>GXSetTevColorOp</CODE></CODE></A></TD> 261<TD>(see above)</TD> 262<TD>RS</TD> 263 </TR> 264 <TR> 265<TD><A href="Tev/GXSetTevAlphaOp.html"><CODE><CODE>GXSetTevAlphaOp</CODE></CODE></A></TD> 266<TD>(see above and below)</TD> 267<TD>RS</TD> 268 </TR> 269 <TR> 270<TD><A href="Tev/GXSetTevSwapMode.html"><CODE><CODE>GXSetTevSwapMode</CODE></CODE></A></TD> 271<TD>(shares register with TevAlphaOp[stage])</TD> 272<TD>RS</TD> 273 </TR> 274 <TR> 275 <TD> </TD> 276 <TD> </TD> 277 <TD> </TD> 278 </TR> 279 <TR> 280<TD><A href="Tev/GXSetTevKColorSel.html"><CODE><CODE>GXSetTevKColorSel</CODE></CODE></A></TD> 281<TD>(Two stages per register, also SwapTable)</TD> 282<TD>RS</TD> 283 </TR> 284 <TR> 285<TD><A href="Tev/GXSetTevKAlphaSel.html"><CODE><CODE>GXSetTevKAlphaSel</CODE></CODE></A></TD> 286<TD>(Two stages per register, also SwapTable)</TD> 287<TD>RS</TD> 288 </TR> 289 <TR> 290<TD><A href="Tev/GXSetTevSwapModeTable.html"><CODE><CODE>GXSetTevSwapModeTable</CODE></CODE></A></TD> 291<TD>(shares reg's with Ksel's; 1st table in 1st 2 reg's, etc.)</TD> 292<TD>RS</TD> 293 </TR> 294 <TR> 295 <TD> </TD> 296 <TD> </TD> 297 <TD> </TD> 298 </TR> 299 <TR> 300<TD><A href="Indirect/GXSetIndTexCoordScale.html"><CODE><CODE>GXSetIndTexCoordScale</CODE></CODE></A></TD> 301<TD>(Two stages per register)</TD> 302<TD>RS</TD> 303 </TR> 304 <TR> 305 <TD> </TD> 306 <TD> </TD> 307 <TD> </TD> 308 </TR> 309 <TR> 310 <TD><A href="TexCoordGen/GXSetTexCoordScaleManually.html"><CODE>GXSetTexCoordScaleManually</CODE></A></TD> 311 <TD><EM>suTs0[</EM>coord<EM>], suTs1[</EM>coord<EM>]</EM></TD> 312 <TD>RS</TD> 313 </TR> 314 <TR> 315 <TD><A href="TexCoordGen/GXSetTexCoordCylWrap.html"><CODE>GXSetTexCoordCylWrap</CODE></A></TD> 316 <TD><EM>suTs0[</EM>coord<EM>], suTs1[</EM>coord<EM>]</EM></TD> 317 <TD>RS</TD> 318 </TR> 319 <TR> 320 <TD><A href="TexCoordGen/GXSetTexCoordBias.html"><CODE>GXSetTexCoordBias</CODE></A></TD> 321 <TD><EM>suTs0[</EM>coord<EM>], suTs1[</EM>coord<EM>]</EM></TD> 322 <TD>RS</TD> 323 </TR> 324 <TR> 325 <TD><A href="Geometry/GXEnableTexOffsets.html"><CODE>GXEnableTexOffsets</CODE></A></TD> 326 <TD><EM>suTs0[</EM>coord<EM>]</EM></TD> 327 <TD>RS</TD> 328 </TR> 329 <TR> 330 <TD> </TD> 331 <TD> </TD> 332 <TD> </TD> 333 </TR> 334 <TR> 335 <TD><A href="Geometry/GXSetLineWidth.html"><CODE>GXSetLineWidth</CODE></A></TD> 336 <TD><EM>lpsize</EM></TD> 337 <TD>RS</TD> 338 </TR> 339 <TR> 340 <TD><A href="Geometry/GXSetPointSize.html"><CODE>GXSetPointSize</CODE></A></TD> 341 <TD><EM>lpsize</EM></TD> 342 <TD>RS</TD> 343 </TR> 344 <TR> 345 <TD><A href="PixelProc/GXSetFieldMode.html"><CODE>GXSetFieldMode</CODE></A></TD> 346 <TD><EM>lpsize</EM> (also texture flush; see below)</TD> 347 <TD>RS</TD> 348 </TR> 349 <TR> 350 <TD> </TD> 351 <TD> </TD> 352 <TD> </TD> 353 </TR> 354 <TR> 355 <TD><A href="Texture/GXInvalidateTexRegion.html"><CODE>GXInvalidateTexRegion</CODE></A></TD> 356 <TD>(texture flush issue; see below)</TD> 357 <TD>RS</TD> 358 </TR> 359 <TR> 360 <TD><A href="Texture/GXInvalidateTexAll.html"><CODE>GXInvalidateTexAll</CODE></A></TD> 361 <TD>(texture flush issue)</TD> 362 <TD>RS</TD> 363 </TR> 364 <TR> 365 <TD><A href="Texture/GXPreLoadEntireTexture.html"><CODE>GXPreLoadEntireTexture</CODE></A></TD> 366 <TD>(texture flush issue)</TD> 367 <TD>RS</TD> 368 </TR> 369 </TBODY> 370</TABLE> 371<P>The "texture flush issue" means that a certain texture register must be written in order to force a texture system flush.<br>That register (<EM>imask</EM>) also happens to control which textures are direct and which are indirect. Refer to the next section (Note: information on <EM>imask</EM> is not included here).</P> 372 373<H2>Functions That Set Pending State</H2> 374<P>These functions can usually be placed in a display list, but there are various issues involved since these functions are not necessarily straightforward in their operation. 'Lazy' means that the register value is not sent right away, but only at the last moment. The following functions will flush any lazy (pending) state before they execute their intended task.</P> 375<UL> 376 <LI><A href="Geometry/GXBegin.html"><CODE>GXBegin</CODE></A> 377 <LI><A href="DisplayList/GXBeginDisplayList.html"><CODE>GXBeginDisplayList</CODE></A> 378 <LI><A href="DisplayList/GXEndDisplayList.html"><CODE>GXEndDisplayList</CODE></A> 379 <LI><A href="DisplayList/GXCallDisplayList.html"><CODE>GXCallDisplayList</CODE></A> 380 <LI><A href="Management/GXFlush.html"><CODE>GXFlush</CODE></A> 381</UL> 382<P>The scaling of texture coordinates is something that also occurs in a lazy fashion. The texture scale registers (<EM>suTs0</EM> and <EM>suTs1</EM>) are per texture coordinate, not per texture. They are set based upon which texture coordinates are associated with which textures. Functions that can possibly affect this mapping thus trigger a flag to set these registers at the last moment, and this is indicated by 'scale issue' in the list below. This issue can be avoided by setting all of the scale values manually. The GX library allows this by calling the <a href="TexCoordGen/GXSetTexCoordScaleManually.html"><CODE>GXSetTexCoordScaleManually</CODE></a> function.</P> 383<P>The <EM>TMEM region issue</EM> means that these functions call the appropriate TMEM region allocator in order to know what region of TMEM to use. Putting these functions into display lists fixes the region of TMEM that is used. You must therefore deal with TMEM allocation carefully. 384</P> 385<TABLE border="1" cellpadding="3" cellspacing="0"> 386 <TBODY> 387 <TR> 388<TD width="205"><B>Functions</B></TD> 389<TD width="330"><B>Shared Register Name (or issue)</B></TD> 390<TD width="94"><B>Register Type</B></TD> 391 </TR> 392 <TR> 393 <TD><A href="TexCoordGen/GXSetNumTexGens.html"><CODE>GXSetNumTexGens</CODE></A></TD> 394 <TD><EM>genmode</EM> (lazy)</TD> 395 <TD>RS</TD> 396 </TR> 397 <TR> 398 <TD><A href="Lighting/GXSetNumChans.html"><CODE>GXSetNumChans</CODE></A> </TD> 399 <TD><EM>genmode</EM> (lazy)</TD> 400 <TD>RS</TD> 401 </TR> 402 <TR> 403<TD><A href="Culling/GXSetCullMode.html"><CODE><CODE>GXSetCullMode</CODE></CODE></A></TD> 404<TD><EM>genmode</EM> (lazy)</TD> 405<TD>RS</TD> 406 </TR> 407 <TR> 408<TD><A href="Tev/GXSetNumTevStages.html"><CODE><CODE>GXSetNumTevStages</CODE></CODE></A></TD> 409<TD><EM>genmode</EM> (lazy) (scale issue)</TD> 410<TD>RS</TD> 411 </TR> 412 <TR> 413<TD><A href="Indirect/GXSetNumIndStages.html"><CODE><CODE>GXSetNumIndStages</CODE></CODE></A></TD> 414<TD><em>genmode</em> (lazy) <em>imask</em> (lazy) (scale issue)</TD> 415<TD>RS</TD> 416 </TR> 417 <TR> 418<TD><A href="Indirect/GXSetIndTexOrder.html"><CODE><CODE>GXSetIndTexOrder</CODE></CODE></A></TD> 419<TD><EM>imask</EM> (lazy) (scale issue) (all 4 stages in one register)</TD> 420<TD>RS</TD> 421 </TR> 422 <TR> 423<TD><A href="Tev/GXSetTevOrder.html"><CODE><CODE>GXSetTevOrder</CODE></CODE></A></TD> 424<TD>(scale issue) (two stages per register)</TD> 425<TD>RS</TD> 426 </TR> 427 <TR> 428 <TD><A href="Texture/GXLoadTexObjPreLoaded.html"><CODE>GXLoadTexObjPreLoaded</CODE></A></TD> 429 <TD>(scale issue)</TD> 430 <TD>RS</TD> 431 </TR> 432 <TR> 433<TD><A href="Texture/GXLoadTexObj.html"><CODE><CODE>GXLoadTexObj</CODE></CODE></A></TD> 434<TD>(scale issue) (tmem region issue)</TD> 435<TD>RS</TD> 436 </TR> 437 <TR> 438 <TD><A href="Texture/GXLoadTlut.html"><CODE>GXLoadTlut</CODE></A></TD> 439 <TD>(tmem region issue)</TD> 440 <TD>RS</TD> 441 </TR> 442 <TR> 443 <TD> </TD> 444 <TD> </TD> 445 <TD> </TD> 446 </TR> 447 <TR> 448 <TD><A href="Transform/GXSetCurrentMtx.html"><CODE>GXSetCurrentMtx</CODE></A></TD> 449 <TD>(current matrix registers)</TD> 450 <TD>CP, XF</TD> 451 </TR> 452 <TR> 453 <TD><A href="TexCoordGen/GXSetTexCoordGen.html"><CODE>GXSetTexCoordGen</CODE></A></TD> 454 <TD>(current matrix registers)</TD> 455 <TD>CP, XF</TD> 456 </TR> 457 <TR> 458<TD><a href="TexCoordGen/GXSetTexCoordGen2.html"><CODE><CODE>GXSetTexCoordGen2</CODE></CODE></a></TD> 459<TD>(current matrix registers)</TD> 460<TD>CP, XF</TD> 461 </TR> 462 <TR> 463 <TD> </TD> 464 <TD> </TD> 465 <TD> </TD> 466 </TR> 467 <TR> 468<TD><A href="Lighting/GXSetChanAmbColor.html"><CODE><CODE>GXSetChanAmbColor</CODE></CODE></A></TD> 469<TD>(writes whole register: COLOR0A0 or COLOR1A1)</TD> 470<TD>XF</TD> 471 </TR> 472 <TR> 473<TD><A href="Lighting/GXSetChanMatColor.html"><CODE><CODE>GXSetChanMatColor</CODE></CODE></A></TD> 474<TD>(writes whole register: COLOR0A0 or COLOR1A1)</TD> 475<TD>XF</TD> 476 </TR> 477 <TR> 478<TD><A href="Lighting/GXSetChanCtrl.html"><CODE><CODE>GXSetChanCtrl</CODE></CODE></A></TD> 479<TD>(delayed to improve processing efficiency)</TD> 480<TD>XF</TD> 481 </TR> 482 <TR> 483 <TD> </TD> 484 <TD> </TD> 485 <TD> </TD> 486 </TR> 487 <TR> 488<TD><A href="Transform/GXSetProjection.html"><CODE>GXSetProjection</CODE></A>/<CODE><A href="Transform/GXSetProjectionv.html">v</A></CODE></TD> 489<TD>(delayed to improve processing efficiency)</TD> 490<TD>XF</TD> 491 </TR> 492 <TR> 493<TD><A href="Transform/GXSetViewport.html"><CODE>GXSetViewport</CODE></A>/<A href="Transform/GXSetViewportJitter.html"><CODE>Jitter</CODE></A></TD> 494<TD>(delayed to improve processing efficiency)</TD> 495<TD>XF</TD> 496 </TR> 497 <TR> 498 <TD> </TD> 499 <TD> </TD> 500 <TD> </TD> 501 </TR> 502 <TR> 503 <TD><A href="Geometry/GXSetVtxDesc.html"><CODE>GXSetVtxDesc</CODE></A> / <A href="Geometry/GXSetVtxDescv.html"><CODE>v</CODE></A></TD> 504 <TD>VCD registers, <EM>invertexspec</EM> (lazy)</TD> 505 <TD>CP</TD> 506 </TR> 507 <TR> 508 <TD><A href="Geometry/GXClearVtxDesc.html"><CODE>GXClearVtxDesc</CODE></A></TD> 509 <TD>VCD registers, <EM>invertexspec</EM> (lazy)</TD> 510 <TD>CP</TD> 511 </TR> 512 <TR> 513 <TD><A href="Geometry/GXSetVtxAttrFmt.html"><CODE>GXSetVtxAttrFmt</CODE></A> / <A href="Geometry/GXSetVtxAttrFmtv.html"><CODE>v</CODE></A></TD> 514 <TD>VAT[vat] registers (lazy)</TD> 515 <TD>CP</TD> 516 </TR> 517 <TR> 518 <TD> </TD> 519 <TD> </TD> 520 <TD> </TD> 521 </TR> 522 <TR> 523<TD><A href="Framebuffer/GXSetDispCopySrc.html"><CODE>GXSetDispCopySrc</CODE></A></TD> 524<TD>(does not send any registers itself; stores to GX)</TD> 525<TD>RS</TD> 526 </TR> 527 <TR> 528<TD><A href="Framebuffer/GXSetTexCopySrc.html"><CODE>GXSetTexCopySrc</CODE></A></TD> 529<TD>(does not send any registers itself; stores to GX)</TD> 530<TD>RS</TD> 531 </TR> 532 <TR> 533<TD><A href="Framebuffer/GXSetDispCopyDst.html"><CODE>GXSetDispCopyDst</CODE></A></TD> 534<TD>(does not send any registers itself; stores to GX)</TD> 535<TD>RS</TD> 536 </TR> 537 <TR> 538<TD><A href="Framebuffer/GXSetTexCopyDst.html"><CODE>GXSetTexCopyDst</CODE></A></TD> 539<TD>(does not send any registers itself; stores to GX)</TD> 540<TD>RS</TD> 541 </TR> 542 <TR> 543<TD><A href="Framebuffer/GXSetDispCopyFrame2Field.html"><CODE>GXSetDispCopyFrame2Field</CODE></A></TD> 544<TD>(does not send any registers itself; stores to GX)</TD> 545<TD>RS</TD> 546 </TR> 547 <TR> 548<TD><A href="Framebuffer/GXSetCopyClamp.html"><CODE>GXSetCopyClamp</CODE></A></TD> 549<TD>(does not send any registers itself; stores to GX)</TD> 550<TD>RS</TD> 551 </TR> 552 <TR> 553<TD><A href="Framebuffer/GXSetDispCopyYScale.html"><CODE>GXSetDispCopyYScale</CODE></A></TD> 554<TD>(does not send any registers itself; stores to GX)</TD> 555<TD>RS</TD> 556 </TR> 557 <TR> 558<TD><A href="Framebuffer/GXSetDispCopyGamma.html"><CODE>GXSetDispCopyGamma</CODE></A></TD> 559<TD>(does not send any registers itself; stores to GX)</TD> 560<TD>RS</TD> 561 </TR> 562 <TR> 563 <TD> </TD> 564 <TD> </TD> 565 <TD> </TD> 566 </TR> 567 <TR> 568<TD><A href="Framebuffer/GXCopyDisp.html"><CODE>GXCopyDisp</CODE></A></TD> 569<TD>(sends registers set by above)</TD> 570<TD>RS</TD> 571 </TR> 572 <TR> 573<TD><A href="Framebuffer/GXCopyTex.html"><CODE>GXCopyTex</CODE></A></TD> 574<TD>(sends registers set by above)</TD> 575<TD>RS</TD> 576 </TR> 577 </TBODY> 578</TABLE> 579<P>Be aware that the <A href="Framebuffer/GXCopyDisp.html"><CODE>GXCopyDisp</CODE></A> and <A href="Framebuffer/GXCopyTex.html"><CODE>GXCopyTex</CODE></A> functions may possibly change various other registers (including <EM>pectrl</EM>, <EM>zmode</EM> and <EM>cmode0</EM>) depending upon the operation and what the registers (shadows) were before the operation. The old register shadow values are restored after the copy operation. 580</P> 581 582<H2>Other</H2> 583<P>The <A href="Draw/GXDrawCube.html"><CODE>GXDraw</A>*</CODE> functions all get and restore the current VCD/VAT (based upon the GX shadow copies).</P> 584<P><STRONG>Note:</STRONG> The following GX functions should not be placed inside the display list. Operation is <STRONG>not guaranteed</STRONG> if these functions are included.<br> 585<UL> 586 <LI><A href="Management/GXInit.html"><CODE>GXInit</CODE></A><br> 587 <LI><A href="Management/GXAbortFrame.html"><CODE>GXAbortFrame</CODE></A><br> 588 <LI><A href="Management/GXDrawDone.html"><CODE>GXDrawDone</CODE></A><br> 589 <LI><A href="Management/GXSetDrawDone.html"><CODE>GXSetDrawDone</CODE></A><br> 590 <LI><A href="Management/GXWaitDrawDone.html"><CODE>GXWaitDrawDone</CODE></A><br> 591 <LI><A href="DisplayList/GXBeginDisplayList.html"><CODE>GXBeginDisplayList</CODE></A><br> 592 <LI><A href="DisplayList/GXEndDisplayList.html"><CODE>GXEndDisplayList</CODE></A><br> 593 <LI><A href="DisplayList/GXCallDisplayList.html"><CODE>GXCallDisplayList</CODE></A><br> 594 <LI><A href="DisplayList/GXFastCallDisplayList.html"><CODE>GXFastCallDisplayList</CODE></A><br> 595 <LI><A href="GfxFIFO/GXSetCPUFifo.html"><CODE>GXSetCPUFifo</CODE></A><br> 596 <LI><A href="GfxFIFO/GXRedirectWriteGatherPipe.html"><CODE>GXRedirectWriteGatherPipe</CODE></A><br> 597 <LI><A href="GfxFIFO/GXRestoreWriteGatherPipe.html"><CODE>GXRestoreWriteGatherPipe</CODE></A><br> 598 <LI><A href="GfxFIFO/GXResetWriteGatherPipe.html"><CODE>GXResetWriteGatherPipe</CODE></A><br> 599</UL> 600</P> 601 602<H2>Revision History</H2> 603<P> 6042008/06/04 Added a list of functions that should not be placed in the display list.<br>2008/05/13 Added a precaution about the functions that may be placed in the display list.<br> 2006/03/01 Initial version.<br><br> 605</P> 606 607<hr><p>CONFIDENTIAL</p></body> 608</HTML>