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_TrySetBankForTex</title> 9<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css"> 10</head> 11 12<body> 13 14<h1 align="left">GX_TrySetBankForTex <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 <nitro/gx/gx_vramcnt.h></CODE><BR> 20 <BR> 21 <CODE>BOOL GX_TrySetBankForTex(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> 32Returns TRUE if the VRAM bank is allocated normally. Returns FALSE if the VRAM bank to be allocated is locked by another library. 33</p> 34<H2>Description</H2> 35<P>Attempts to allocate a VRAM bank to the TextureImage slot. If the specified VRAM bank is either disabled or allocated to LCDC, this allocates the VRAM bank to the texture image slot. The allocation will fail if the designated VRAM bank is exclusion-locked by another library. 36</P> 37<TABLE border="1"> 38 <TBODY> 39 <TR> 40 <TD><CODE>GX_VRAM_TEX_NONE</CODE></TD> 41 <TD>The VRAM bank is not allocated to the texture image.</TD> 42 </TR> 43 <TR> 44 <TD><CODE>GX_VRAM_TEX_0_A</CODE></TD> 45 <TD>Slot 0 of the texture image is reserved. VRAM-A is allocated.</TD> 46 </TR> 47 <TR> 48 <TD><CODE>GX_VRAM_TEX_0_B</CODE></TD> 49 <TD>Slot 0 of the texture image is reserved. VRAM-B is allocated.</TD> 50 </TR> 51 <TR> 52 <TD><CODE>GX_VRAM_TEX_0_C</CODE></TD> 53 <TD>Slot 0 of the texture image is reserved. VRAM-C is allocated.</TD> 54 </TR> 55 <TR> 56 <TD><CODE>GX_VRAM_TEX_0_D</CODE></TD> 57 <TD>Slot 0 of the texture image is reserved. VRAM-D is allocated.</TD> 58 </TR> 59 <TR> 60 <TD><CODE>GX_VRAM_TEX_01_AB</CODE></TD> 61 <TD>Slot 0,1 of the texture image is reserved. VRAM-A and -B are allocated.</TD> 62 </TR> 63 <TR> 64 <TD><CODE>GX_VRAM_TEX_01_BC</CODE></TD> 65 <TD>Slot 0,1 of the texture image is reserved. VRAM-B and -C are allocated.</TD> 66 </TR> 67 <TR> 68 <TD><CODE>GX_VRAM_TEX_01_CD</CODE></TD> 69 <TD>Slot 0,1 of the texture image is reserved. VRAM-C and -D are allocated.</TD> 70 </TR> 71 <TR> 72 <TD><CODE>GX_VRAM_TEX_012_ABC</CODE></TD> 73 <TD>Slots 0, 1, and 2 of the texture image are reserved. VRAM-A, -B, and -C are allocated.</TD> 74 </TR> 75 <TR> 76 <TD><CODE>GX_VRAM_TEX_012_BCD</CODE></TD> 77 <TD>Slots 0, 1, and 2 of the texture image are reserved. VRAM-B, -C, and -D are allocated.</TD> 78 </TR> 79 <TR> 80 <TD><CODE>GX_VRAM_TEX_0123_ABCD</CODE></TD> 81 <TD>Slots 0, 1, 2, and 3 of the texture image are reserved. VRAM-A, -B, -C, and -D are allocated.</TD> 82 </TR> 83 <TR> 84 <TD><CODE>GX_VRAM_TEX_01_AC</CODE></TD> 85 <TD>Slot 0,1 of the texture image is reserved. VRAM-A and -C are allocated.</TD> 86 </TR> 87 <TR> 88 <TD><CODE>GX_VRAM_TEX_01_AD</CODE></TD> 89 <TD>Slot 0,1 of the texture image is reserved. VRAM-A and -D are allocated.</TD> 90 </TR> 91 <TR> 92 <TD><CODE>GX_VRAM_TEX_01_BD</CODE></TD> 93 <TD>Slot 0,1 of the texture image is reserved. VRAM-B and -D are allocated.</TD> 94 </TR> 95 <TR> 96 <TD><CODE>GX_VRAM_TEX_012_ABD</CODE></TD> 97 <TD>Slots 0, 1, and 2 of the texture image are reserved. VRAM-A, -B, and -D are allocated.</TD> 98 </TR> 99 <TR> 100 <TD><CODE>GX_VRAM_TEX_012_ACD</CODE></TD> 101 <TD>Slots 0, 1, and 2 of the texture image are reserved. VRAM-A, -C, and -D are allocated.</TD> 102 </TR> 103 </TBODY> 104</TABLE> 105<P>The following is the type definition for <CODE>GXVRamTex</CODE> types.</P> 106<PRE><CODE>typedef enum 107{ 108 GX_VRAM_TEX_NONE = 0x0000, // none 109 GX_VRAM_TEX_0_A = GX_VRAM_A, // TextureImageSlot 0 110 GX_VRAM_TEX_0_B = GX_VRAM_B, // TextureImageSlot 0 111 GX_VRAM_TEX_0_C = GX_VRAM_C, // TextureImageSlot 0 112 GX_VRAM_TEX_0_D = GX_VRAM_D, // TextureImageSlot 0 113 GX_VRAM_TEX_01_AB = GX_VRAM_A | GX_VRAM_B, // TextureImageSlot 01 114 GX_VRAM_TEX_01_BC = GX_VRAM_B | GX_VRAM_C, // TextureImageSlot 01 115 GX_VRAM_TEX_01_CD = GX_VRAM_C | GX_VRAM_D, // TextureImageSlot 01 116 GX_VRAM_TEX_012_ABC = GX_VRAM_A | GX_VRAM_B | GX_VRAM_C, // TextureImageSlot 012 117 GX_VRAM_TEX_012_BCD = GX_VRAM_B | GX_VRAM_C | GX_VRAM_D, // TextureImageSlot 012 118 GX_VRAM_TEX_0123_ABCD = GX_VRAM_A | GX_VRAM_B | GX_VRAM_C | GX_VRAM_D, // TextureImageSlot 0123 119 120 // The following settings are discontinuous on LCDC 121 GX_VRAM_TEX_01_AC = GX_VRAM_A | GX_VRAM_C, // TextureImageSlot 01 122 GX_VRAM_TEX_01_AD = GX_VRAM_A | GX_VRAM_D, // TextureImageSlot 01 123 GX_VRAM_TEX_01_BD = GX_VRAM_B | GX_VRAM_D, // TextureImageSlot 01 124 GX_VRAM_TEX_012_ABD = GX_VRAM_A | GX_VRAM_B | GX_VRAM_D, // TextureImageSlot 012 125 GX_VRAM_TEX_012_ACD = GX_VRAM_A | GX_VRAM_C | GX_VRAM_D // TextureImageSlot 012 126} 127GXVRamTex;</CODE></PRE> 128<h2>See Also</h2> 129<P><code><A href="GX_SetBankForTex.html">GX_SetBankForTex</A>, <A href="GX_GetBankForTex.html">GX_GetBankForTex</A>, <A href="GX_ResetBankForTex.html">GX_ResetBankForTex</A>, <A href="GX_DisableBankForTex.html">GX_DisableBankForTex</A>, <A href="GX_GetSizeOfTex.html">GX_GetSizeOfTex</A></code></P> 130<H2>Revision History</H2> 131<P>2005/02/15 Initial version.</P> 132<hr><p>CONFIDENTIAL</p></body> 133</html> 134
