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="IBM WebSphere Studio Homepage Builder Version 8.0.0.0 for Windows">
7<META http-equiv="Content-Style-Type" content="text/css">
8<title>GX_SetBankForTex</title>
9<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
10</head>
11
12<body>
13
14<h1 align="left">GX_SetBankForTex <img src="../../image/NTR.gif"align="middle"><img src="../../image/TWL.gif" align="middle"></H1>
15<H2>Syntax</H2>
16
17<dl>
18  <dd>
19<CODE>#include &lt;nitro/gx/gx_vramcnt.h&gt;</CODE><BR>
20  <BR>
21  <CODE>void GX_SetBankForTex(GXVRamTex tex);</CODE></dd>
22</dl><h2>Arguments</h2>
23
24<table border="1" width="100%">
25  <tr>
26    <td width="13%"><em><strong><font face="Courier New">tex</font></strong></em></td>
27    <td width="87%">Specifies a VRAM bank to allocate to the texture image slot</td>
28  </tr>
29  </table>
30<h2>Return Values</h2>
31<p>None.</p>
32<H2>Description</H2>
33<P>This function allocates the specified VRAM bank to the texture image slot. If the specified VRAM bank is either disabled or allocated to LCDC, this allocates the VRAM bank to the texture image slot.
34</P>
35<TABLE border="1">
36  <TBODY>
37    <TR>
38      <TD><CODE>GX_VRAM_TEX_NONE</CODE></TD>
39      <TD>The VRAM bank is not allocated to the texture image.</TD>
40    </TR>
41    <TR>
42      <TD><CODE>GX_VRAM_TEX_0_A</CODE></TD>
43      <TD>Slot 0 of the texture image is reserved. VRAM-A is allocated.</TD>
44    </TR>
45    <TR>
46      <TD><CODE>GX_VRAM_TEX_0_B</CODE></TD>
47      <TD>Slot 0 of the texture image is reserved. VRAM-B is allocated.</TD>
48    </TR>
49    <TR>
50      <TD><CODE>GX_VRAM_TEX_0_C</CODE></TD>
51      <TD>Slot 0 of the texture image is reserved. VRAM-C is allocated.</TD>
52    </TR>
53    <TR>
54      <TD><CODE>GX_VRAM_TEX_0_D</CODE></TD>
55      <TD>Slot 0 of the texture image is reserved. VRAM-D is allocated.</TD>
56    </TR>
57    <TR>
58      <TD><CODE>GX_VRAM_TEX_01_AB</CODE></TD>
59      <TD>Slot 0,1 of the texture image is reserved. VRAM-A and -B are allocated.</TD>
60    </TR>
61    <TR>
62      <TD><CODE>GX_VRAM_TEX_01_BC</CODE></TD>
63      <TD>Slot 0,1 of the texture image is reserved. VRAM-B and -C are allocated.</TD>
64    </TR>
65    <TR>
66      <TD><CODE>GX_VRAM_TEX_01_CD</CODE></TD>
67      <TD>Slot 0,1 of the texture image is reserved. VRAM-C and -D are allocated.</TD>
68    </TR>
69    <TR>
70      <TD><CODE>GX_VRAM_TEX_012_ABC</CODE></TD>
71      <TD>Slots 0, 1, and 2 of the texture image are reserved. VRAM-A, -B, and -C are allocated.</TD>
72    </TR>
73    <TR>
74      <TD><CODE>GX_VRAM_TEX_012_BCD</CODE></TD>
75      <TD>Slots 0, 1, and 2 of the texture image are reserved. VRAM-B, -C, and -D are allocated.</TD>
76    </TR>
77    <TR>
78      <TD><CODE>GX_VRAM_TEX_0123_ABCD</CODE></TD>
79      <TD>Slots 0, 1, 2, and 3 of the texture image are reserved. VRAM-A, -B, -C, and -D are allocated.</TD>
80    </TR>
81    <TR>
82      <TD><CODE>GX_VRAM_TEX_01_AC</CODE></TD>
83      <TD>Slot 0,1 of the texture image is reserved. VRAM-A and -C are allocated.</TD>
84    </TR>
85    <TR>
86      <TD><CODE>GX_VRAM_TEX_01_AD</CODE></TD>
87      <TD>Slot 0,1 of the texture image is reserved. VRAM-A and -D are allocated.</TD>
88    </TR>
89    <TR>
90      <TD><CODE>GX_VRAM_TEX_01_BD</CODE></TD>
91      <TD>Slot 0,1 of the texture image is reserved. VRAM-B and -D are allocated.</TD>
92    </TR>
93    <TR>
94      <TD><CODE>GX_VRAM_TEX_012_ABD</CODE></TD>
95      <TD>Slots 0, 1, and 2 of the texture image are reserved. VRAM-A, -B, and -D are allocated.</TD>
96    </TR>
97    <TR>
98      <TD><CODE>GX_VRAM_TEX_012_ACD</CODE></TD>
99      <TD>Slots 0, 1, and 2 of the texture image are reserved. VRAM-A, -C, and -D are allocated.</TD>
100    </TR>
101  </TBODY>
102</TABLE>
103<P>The following is the type definition for <CODE>GXVRamTex</CODE> types.</P>
104<PRE><CODE>typedef enum
105{
106    GX_VRAM_TEX_NONE  = 0x0000,                               // none
107    GX_VRAM_TEX_0_A   = GX_VRAM_A,                            // TextureImageSlot 0
108    GX_VRAM_TEX_0_B   = GX_VRAM_B,                            // TextureImageSlot 0
109    GX_VRAM_TEX_0_C   = GX_VRAM_C,                            // TextureImageSlot 0
110    GX_VRAM_TEX_0_D   = GX_VRAM_D,                            // TextureImageSlot 0
111    GX_VRAM_TEX_01_AB = GX_VRAM_A | GX_VRAM_B,                // TextureImageSlot 01
112    GX_VRAM_TEX_01_BC = GX_VRAM_B | GX_VRAM_C,                // TextureImageSlot 01
113    GX_VRAM_TEX_01_CD = GX_VRAM_C | GX_VRAM_D,                // TextureImageSlot 01
114    GX_VRAM_TEX_012_ABC = GX_VRAM_A | GX_VRAM_B | GX_VRAM_C,  // TextureImageSlot 012
115    GX_VRAM_TEX_012_BCD = GX_VRAM_B | GX_VRAM_C | GX_VRAM_D,  // TextureImageSlot 012
116    GX_VRAM_TEX_0123_ABCD = GX_VRAM_A | GX_VRAM_B | GX_VRAM_C | GX_VRAM_D,  // TextureImageSlot 0123
117
118    // The following settings are discontinuous on LCDC
119    GX_VRAM_TEX_01_AC = GX_VRAM_A | GX_VRAM_C,                // TextureImageSlot 01
120    GX_VRAM_TEX_01_AD = GX_VRAM_A | GX_VRAM_D,                // TextureImageSlot 01
121    GX_VRAM_TEX_01_BD = GX_VRAM_B | GX_VRAM_D,                // TextureImageSlot 01
122    GX_VRAM_TEX_012_ABD = GX_VRAM_A | GX_VRAM_B | GX_VRAM_D,  // TextureImageSlot 012
123    GX_VRAM_TEX_012_ACD = GX_VRAM_A | GX_VRAM_C | GX_VRAM_D   // TextureImageSlot 012
124}
125GXVRamTex;</CODE></PRE>
126<h2>See Also</h2>
127<P><A href="GX_GetBankForTex.html"><code>GX_GetBankForTex</code></A>, <A href="GX_ResetBankForTex.html"><code>GX_ResetBankForTex</code></A>, <A href="GX_DisableBankForTex.html"><code>GX_DisableBankForTex</code></A>, <a href="GX_GetSizeOfTex.html"><code>GX_GetSizeOfTex</code></a></P>
128<H2>Revision History</H2>
129<P>2004/01/19 Initial version.</P>
130<hr><p>CONFIDENTIAL</p></body>
131</html>
132