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>GXLoadTexObjPreLoaded</title> 10</head> 11 12<body> 13 14<h1 align="left">GXLoadTexObjPreLoaded</h1> 15 16<h2>Syntax</h2> 17<dl><dd><pre class="construction"> 18#include <revolution/gx.h> 19 20void GXLoadTexObjPreLoaded( 21 const <a href="../Structures/GXTexObj.html">GXTexObj</a>* obj, 22 const <a href="../Structures/GXTexRegion.html">GXTexRegion</a>* region, 23 <a href="../Enumerated_Types/GXTexMapID.html">GXTexMapID</a> id ); 24</pre></dd></dl> 25 26<h2>Arguments</h2> 27<TABLE class="arguments" border="1" > 28 <tr> 29<TH><em><strong><code>obj</code></strong></em></TH> 30<TD>Pointer to the texture object that describes the texture and its properties.</TD> 31 </tr> 32 <tr> 33<TH>region</TH> 34<TD>Pointer to a region object that describes the texture memory region.</TD> 35 </tr> 36 <tr> 37<TH>id</TH> 38<TD>Texture name referenced by the texture environment (TEV) stage</TD> 39 </tr> 40</TABLE> 41 42<h2>Return Values</h2> 43<p>None.</p> 44 45<H2>Description</H2> 46<P>This function loads the state describing a preloaded texture into one of eight hardware register sets. Before this happens, the texture object, <SPAN class="argument">obj</SPAN>, should be initialized using the <A href="GXInitTexObj.html"><CODE>GXInitTexObj</CODE></A> or <A href="GXInitTexObjCI.html"><CODE>GXInitTexObjCI</CODE></A> function. The <SPAN class="argument">id</SPAN> argument refers to the texture state register set. The texture must be loaded beforehand using the <A href="GXPreLoadEntireTexture.html"><CODE>GXPreLoadEntireTexture</CODE></A> function.</P> 47<P>Once loaded, the texture can be used in any texture environment (TEV) stage using the <A href="../Tev/GXSetTevOrder.html"><CODE>GXSetTevOrder</CODE></A> function. The <A href="../Management/GXInit.html"><CODE>GXInit</CODE></A> function initially calls the <A href="../Tev/GXSetTevOrder.html"><CODE>GXSetTevOrder</CODE></A> function to make a simple texture pipeline that associates <code>GX_TEXMAP0</code> with <code>GX_TEVSTAGE0</code>, <code>GX_TEXMAP1</code> with <code>GX_TEVSTAGE1</code>, and so on.</P> 48<P>Be aware that the <A href="GXLoadTexObjPreLoaded.html"><CODE>GXLoadTexObjPreLoaded</CODE></A> function will not call the functions set by the <A href="GXSetTexRegionCallback.html"><CODE>GXSetTexRegionCallBack</CODE></A> function (or the <A href="GXSetTlutRegionCallback.html"><CODE>GXSetTlutRegionCallBack</CODE></A> function, if the texture is color index format). because the region is explicitly set. However, these callback functions must be aware of all regions that are preloaded. The default callbacks set by the <A href="../Management/GXInit.html"><CODE>GXInit</CODE></A> function assume there are no preloaded regions.</P> 49 50<h2>See Also</h2> 51<P class="reference"> 52<a href="GXPreLoadEntireTexture.html">GXPreLoadEntireTexture</a>, 53<a href="../Tev/GXSetTevOrder.html">GXSetTevOrder</a>, 54<a href="../Management/GXInit.html">GXInit</a>, 55<a href="GXInitTexObj.html">GXInitTexObj</a>, 56<a href="GXInitTexObjCI.html">GXInitTexObjCI</a>, 57<A href="GXSetTexRegionCallback.html">GXSetTexRegionCallBack</A>, 58<A href="GXSetTlutRegionCallback.html">GXSetTlutRegionCallBack</A> 59</p> 60 61<H2>Revision History</H2> 62<P> 632006/03/01 Initial version.<br> 64</P> 65 66<hr><p>CONFIDENTIAL</p></body> 67</HTML>