# GX_TrySetBankForSubOBJExtPltt

## 構文

  `#include <nitro/gx/gx_vramcnt.h>`
  `BOOL GX_TrySetBankForSubOBJExtPltt(GXVRamSubOBJExtPltt objExtPltt);`

## 引数

objExtPltt | サブ2DエンジンのOBJ拡張パレットに割り当てるVRAMバンクを指定

## 返り値

正常にVRAMバンクが割り当てられた場合にTRUEを返します。
割り当てようとするVRAMバンクが別ライブラリによってロックされている場合にはFALSEを返します。

## 説明

サブ2DエンジンのOBJ拡張パレットへ指定されたVRAMバンクの割り当てを試みます。指定されたVRAMバンクがDisableになっているか、LCDCに割り当てられている場合に、そのVRAMバンクをサブ2DエンジンのOBJ拡張パレットに割り当てます。
また、指定したVRAMバンクが他のライブラリによって排他ロックされている場合は割り当てに失敗します。
(注意) OBJ拡張パレットを割り当てた場合、256色OBJはOBJ拡張パレットを使用しますが、16色OBJは常に標準パレットを使用します。

`GX_VRAM_SUB_OBJEXTPLTT_NONE` | OBJ拡張パレットにVRAMバンクを割り当てません。
`GX_VRAM_SUB_OBJEXTPLTT_0_I` | OBJ拡張パレットを確保します。VRAM-Iを割り当てます。

以下に`GXVRamSubOBJExtPltt`型の型定義を示しておきます。

    typedef enum
    {
        GX_VRAM_SUB_OBJEXTPLTT_NONE = 0x0000,
        GX_VRAM_SUB_OBJEXTPLTT_0_I  = GX_VRAM_I
    }
    GXVRamSubOBJExtPltt;

## 参照

GX_SetBankForSubOBJExtPltt, GX_GetSizeOfSubOBJExtPltt, GX_GetBankForSubOBJExtPltt, GX_ResetBankForSubOBJExtPltt, GX_DisableBankForSubOBJExtPltt

## 履歴

Ver. 2005/02/15 初版