# GX_TrySetBankForSubBG

## 構文

  `#include <nitro/gx/gx_vramcnt.h>`
  `BOOL GX_TrySetBankForSubBG(GXVRamSubBG bg);`

## 引数

bg | サブ2DエンジンのBGに割り当てるVRAMバンクを指定

## 返り値

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

## 説明

サブ2DエンジンのＢＧへ指定されたVRAMバンクの割り当てを試みます。指定されたVRAMバンクがDisableになっているか、LCDCに割り当てられている場合に、そのVRAMバンクをサブ2DエンジンのBGに割り当てます。
また、指定したVRAMバンクが他のライブラリによって排他ロックされている場合は割り当てに失敗します。

`GX_VRAM_SUB_BG_NONE` | BGにVRAMバンクを割り当てません。
`GX_VRAM_SUB_BG_128_C` | BGに128KBytes確保します。VRAM-Cを割り当てます。
`GX_VRAM_SUB_BG_32_H` | BGに32KBytes確保します。VRAM-Hを割り当てます。
`GX_VRAM_SUB_BG_48_HI` | BGに48KBytes確保します。VRAM-H,Iを割り当てます。

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

    typedef enum
    {
        GX_VRAM_SUB_BG_NONE = 0x0000,
        GX_VRAM_SUB_BG_128_C = GX_VRAM_C,
        GX_VRAM_SUB_BG_32_H = GX_VRAM_H,
        GX_VRAM_SUB_BG_48_HI = GX_VRAM_H | GX_VRAM_I
    }
    GXVRamSubBG;

## 参照

GX_SetBankForSubBG, GX_GetBankForSubBG, GX_ResetBankForSubBG, GX_DisableBankForSubBG, GX_GetSizeOfSubBG

## 履歴

Ver. 2005/02/15 初版