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_TrySetBankForOBJExtPltt</title>
9<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
10</head>
11
12<body>
13
14<h1 align="left">GX_TrySetBankForOBJExtPltt <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_TrySetBankForOBJExtPltt(GXVRamOBJExtPltt objExtPltt);</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">objExtPltt</font></strong></em></td>
27    <td width="87%">Specifies a VRAM bank to allocate to the main 2D Engine's OBJ Extended 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 the main 2D engine OBJ extended palette. If the specified VRAM bank is either disabled or allocated to LCDC, that VRAM bank is allocated to the Main 2D Engine's OBJ Extended palette. The allocation will fail if the designated VRAM bank is exclusion-locked by another library.<BR> <B>Note: </B> When the OBJ Extended palette is allocated, the 256-color OBJ uses the OBJ Extended palette. However, 16-color OBJs normally use the standard palette.
36</P>
37<TABLE border="1">
38  <TBODY>
39    <TR>
40      <TD><CODE>GX_VRAM_OBJEXTPLTT_NONE</CODE></TD>
41      <TD>A VRAM bank is not allocated to the OBJ Extended palette.</TD>
42    </TR>
43    <TR>
44      <TD><CODE>GX_VRAM_OBJEXTPLTT_8_F</CODE></TD>
45      <TD>The OBJ Extended palette is reserved. VRAM-F is allocated.</TD>
46    </TR>
47    <TR>
48      <TD><CODE>GX_VRAM_OBJEXTPLTT_8_G</CODE></TD>
49      <TD>The OBJ Extended palette is reserved. VRAM-G is allocated.</TD>
50    </TR>
51  </TBODY>
52</TABLE>
53<P><BR> The following is the type definition for <CODE>GXVRamOBJExtPltt</CODE> types.</P>
54<PRE><CODE>typedef enum
55{
56    GX_VRAM_OBJEXTPLTT_NONE = 0x0000,
57    GX_VRAM_OBJEXTPLTT_0_F = GX_VRAM_F,           // OBJExtPltt
58    GX_VRAM_OBJEXTPLTT_0_G = GX_VRAM_G            // OBJExtPltt
59}
60GXVRamOBJExtPltt;</CODE></PRE>
61<h2>See Also</h2>
62<P><code><A href="GX_SetBankForOBJExtPltt.html">GX_SetBankForOBJExtPltt</A>, <A href="GX_GetSizeOfOBJExtPltt.html">GX_GetSizeOfOBJExtPltt</A>, <A href="GX_GetBankForOBJExtPltt.html">GX_GetBankForOBJExtPltt</A>, <A href="GX_ResetBankForOBJExtPltt.html">GX_ResetBankForOBJExtPltt</A>, <A href="GX_DisableBankForOBJExtPltt.html">GX_DisableBankForOBJExtPltt</A></code></P>
63<H2>Revision History</H2>
64<P>2005/02/15 Initial version.</P>
65<hr><p>CONFIDENTIAL</p></body>
66</html>
67