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_TrySetBankForOBJ</title>
9<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
10</head>
11
12<body>
13
14<h1 align="left">GX_TrySetBankForOBJ <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_TrySetBankForOBJ(GXVRamOBJ obj);</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">obj</font></strong></em></td>
27    <td width="87%">Specifies a VRAM bank to allocate to the main 2D Engine's OBJ</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 main 2D engine OBJ. If the specified VRAM bank is either disabled or allocated to LCDC, that VRAM bank is allocated to the Main 2D Engine OBJ. 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_OBJ_NONE</CODE></TD>
41      <TD>VRAM is not allocated to OBJ.</TD>
42    </TR>
43    <TR>
44      <TD><CODE>GX_VRAM_OBJ_16_F</CODE></TD>
45      <TD>16 kilobytes of OBJ are reserved. VRAM-F is allocated.</TD>
46    </TR>
47    <TR>
48      <TD><CODE>GX_VRAM_OBJ_16_G</CODE></TD>
49      <TD>16 kilobytes of OBJ are reserved. VRAM-G is allocated.</TD>
50    </TR>
51    <TR>
52      <TD><CODE>GX_VRAM_OBJ_32_FG</CODE></TD>
53      <TD>32 kilobytes of OBJ are reserved. VRAM-F and -G are allocated.</TD>
54    </TR>
55    <TR>
56      <TD><CODE>GX_VRAM_OBJ_64_E</CODE></TD>
57      <TD>64 kilobytes of OBJ are reserved. VRAM-E is allocated.</TD>
58    </TR>
59    <TR>
60      <TD><CODE>GX_VRAM_OBJ_80_EF</CODE></TD>
61      <TD>80 kilobytes of OBJ are reserved. VRAM-E and -F are allocated.</TD>
62    </TR>
63    <TR>
64      <TD><CODE>GX_VRAM_OBJ_80_EG</CODE></TD>
65      <TD>80 kilobytes of OBJ are reserved. VRAM-E and -G are allocated.</TD>
66    </TR>
67    <TR>
68      <TD><CODE>GX_VRAM_OBJ_96_EFG</CODE></TD>
69      <TD>96 kilobytes of OBJ are reserved. VRAM-E, -F, and -G are allocated.</TD>
70    </TR>
71    <TR>
72      <TD><CODE>GX_VRAM_OBJ_128_A</CODE></TD>
73      <TD>128 kilobytes of OBJ are reserved. VRAM-A is allocated.</TD>
74    </TR>
75    <TR>
76      <TD><CODE>GX_VRAM_OBJ_128_B</CODE></TD>
77      <TD>128 kilobytes of OBJ are reserved. VRAM-B is allocated.</TD>
78    </TR>
79    <TR>
80      <TD><CODE>GX_VRAM_OBJ_256_AB</CODE></TD>
81      <TD>256 kilobytes of OBJ are reserved. VRAM-A and -B are allocated.</TD>
82    </TR>
83  </TBODY>
84</TABLE>
85<P><BR> The following is the type definition for <CODE>GXVRamOBJ</CODE> types.</P>
86<PRE><CODE>typedef enum
87{
88    GX_VRAM_OBJ_NONE   = 0x0000,
89    GX_VRAM_OBJ_16_F   = GX_VRAM_F,                      // ARM9: HW_OBJ_VRAM  --&gt;   HW_OBJ_VRAM + HW_VRAM_F_SIZE
90    GX_VRAM_OBJ_16_G   = GX_VRAM_G,                      // ARM9: HW_OBJ_VRAM  --&gt;   HW_OBJ_VRAM + HW_VRAM_G_SIZE
91    GX_VRAM_OBJ_32_FG  = GX_VRAM_F | GX_VRAM_G,          // ARM9: HW_OBJ_VRAM  --&gt;   HW_OBJ_VRAM + HW_VRAM_F_SIZE + HW_VRAM_G_SIZE
92    GX_VRAM_OBJ_64_E   = GX_VRAM_E,                      // ARM9: HW_OBJ_VRAM  --&gt;   HW_OBJ_VRAM + HW_VRAM_E_SIZE
93    GX_VRAM_OBJ_80_EF  = GX_VRAM_E | GX_VRAM_F,          // ARM9: HW_OBJ_VRAM  --&gt;   HW_OBJ_VRAM + HW_VRAM_E_SIZE + HW_VRAM_F_SIZE
94    GX_VRAM_OBJ_80_EG  = GX_VRAM_E | GX_VRAM_G,          // ARM9: HW_OBJ_VRAM  --&gt;   HW_OBJ_VRAM + HW_VRAM_E_SIZE + HW_VRAM_G_SIZE
95    GX_VRAM_OBJ_96_EFG = GX_VRAM_E | GX_VRAM_F | GX_VRAM_G, // ARM9: HW_OBJ_VRAM  --&gt;   HW_OBJ_VRAM + HW_VRAM_E_SIZE + HW_VRAM_F_SIZE + HW_VRAM_G_SIZE
96    GX_VRAM_OBJ_128_A  = GX_VRAM_A,                      // ARM9: HW_OBJ_VRAM  --&gt;   HW_OBJ_VRAM + HW_VRAM_A_SIZE
97    GX_VRAM_OBJ_128_B  = GX_VRAM_B,                      // ARM9: HW_OBJ_VRAM  --&gt;   HW_OBJ_VRAM + HW_VRAM_B_SIZE
98    GX_VRAM_OBJ_256_AB = GX_VRAM_A | GX_VRAM_B           // ARM9: HW_OBJ_VRAM  --&gt;   HW_OBJ_VRAM + HW_VRAM_A_SIZE + HW_VRAM_B_SIZE
99}
100GXVRamOBJ;</CODE></PRE>
101<h2>See Also</h2>
102<P><code><A href="GX_SetBankForOBJ.html">GX_SetBankForOBJ</A>, <A href="GX_GetBankForOBJ.html">GX_GetBankForOBJ</A>, <A href="GX_ResetBankForOBJ.html">GX_ResetBankForOBJ</A>, <A href="GX_DisableBankForOBJ.html">GX_DisableBankForOBJ</A>, <A href="GX_GetSizeOfOBJ.html">GX_GetSizeOfOBJ</A></code></P>
103<H2>Revision History</H2>
104<P>2005/02/15 Initial version.</P>
105<hr><p>CONFIDENTIAL</p></body>
106</html>
107