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_TrySetBankForTexPltt</title>
9<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
10</head>
11
12<body>
13
14<h1 align="left">GX_TrySetBankForTexPltt <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>BOOL GX_TrySetBankForTexPltt(GXVRamTexPltt texPltt);</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">texPltt</font></strong></em></td>
27    <td width="87%">Specifies a VRAM bank to allocate to the texture palette</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 TexturePalette. If the specified VRAM bank is either disabled or allocated to LCDC, this allocates the VRAM bank to the texture palette. 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_TEXPLTT_NONE</CODE></TD>
41      <TD>A VRAM bank is not allocated to the texture palette.</TD>
42    </TR>
43    <TR>
44      <TD><CODE>GX_VRAM_TEXPLTT_0_F</CODE></TD>
45      <TD>Slot 0 of the texture palette is reserved. VRAM-F is allocated.</TD>
46    </TR>
47    <TR>
48      <TD><CODE>GX_VRAM_TEXPLTT_0_G</CODE></TD>
49      <TD>Slot 0 of the texture palette is reserved. VRAM-G is allocated.</TD>
50    </TR>
51    <TR>
52      <TD><CODE>GX_VRAM_TEXPLTT_01_FG</CODE></TD>
53      <TD>Slot 0,1 of the texture palette is reserved. VRAM-F and -G are allocated.</TD>
54    </TR>
55    <TR>
56      <TD><CODE>GX_VRAM_TEXPLTT_0123_E</CODE></TD>
57      <TD>Slots 0, 1, 2, and 3 of the texture palette are reserved. VRAM-E is allocated.</TD>
58    </TR>
59    <TR>
60      <TD><CODE>GX_VRAM_TEXPLTT_01234_EF</CODE></TD>
61      <TD>Slots 0, 1, 2, 3, and 4 of the texture palette are reserved. VRAM-E and -F are allocated.</TD>
62    </TR>
63    <TR>
64      <TD><CODE>GX_VRAM_TEXPLTT_012345_EFG</CODE></TD>
65      <TD>Slots 0, 1, 2, 3, 4, and 5 of the texture palette are reserved. VRAM-E, -F, and -G are allocated.</TD>
66    </TR>
67  </TBODY>
68</TABLE>
69<P>The following is the type definition for <CODE>GXVRamTexPltt</CODE> types.</P>
70<PRE><CODE>typedef enum
71{
72    GX_VRAM_TEXPLTT_NONE     = 0x0000,
73    GX_VRAM_TEXPLTT_0_F      = GX_VRAM_F,              // TexturePltt 0
74    GX_VRAM_TEXPLTT_0_G      = GX_VRAM_G,              // TexturePltt 0
75    GX_VRAM_TEXPLTT_01_FG    = GX_VRAM_F | GX_VRAM_G,  // TexturePltt 01
76    GX_VRAM_TEXPLTT_0123_E   = GX_VRAM_E,              // TexturePltt 0-3
77    GX_VRAM_TEXPLTT_01234_EF = GX_VRAM_E | GX_VRAM_F,  // TexturePltt 0-3,4
78    GX_VRAM_TEXPLTT_012345_EFG = GX_VRAM_E | GX_VRAM_F | GX_VRAM_G  // TexturePltt 0-3,45
79}
80GXVRamTexPltt;</CODE></PRE>
81<h2>See Also</h2>
82<P><code><A href="GX_SetBankForTexPltt.html">GX_SetBankForTexPltt</A>, <A href="GX_GetBankForTexPltt.html">GX_GetBankForTexPltt</A>, <A href="GX_ResetBankForTexPltt.html">GX_ResetBankForTexPltt</A>, <A href="GX_DisableBankForTexPltt.html">GX_DisableBankForTexPltt</A>, <A href="GX_GetSizeOfTexPltt.html">GX_GetSizeOfTexPltt</A></code></P>
83<H2>Revision History</H2>
84<P>2005/02/15 Initial version.</P>
85<hr><p>CONFIDENTIAL</p></body>
86</html>
87