# GX_SetOBJVRamModeBmp

## 構文

      #include <nitro/gx/gx.h>

      void GX_SetOBJVRamModeBmp(GXOBJVRamModeBmp mode);

## 引数

mode | マッピングモード

## 返り値

なし。

## 説明

ビットマップOBJのOBJ-VRAM容量とマッピングモードを設定します。

`GX_OBJVRAMMODE_BMP_2D_W128` | 横128ドットで2次元マッピングモードを選択します。
`GX_OBJVRAMMODE_BMP_2D_W256` | 横256ドットで2次元マッピングモードを選択します。
`GX_OBJVRAMMODE_BMP_1D_128K` | 1次元マッピングモードで、OBJ-VRAM容量を128KBytesとします。先頭キャラクタネーム境界は128バイトです。
`GX_OBJVRAMMODE_BMP_1D_256K` | 1次元マッピングモードで、OBJ-VRAM容量を256KBytesとします。先頭キャラクタネーム境界は256バイトです。

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

    typedef enum
    {
        GX_OBJVRAMMODE_BMP_2D_W128 = (0 << REG_GX_DISPCNT_OBJMAP_SHIFT + 1) | (0 << REG_GX_DISPCNT_EXOBJ_SHIFT + 2),
        GX_OBJVRAMMODE_BMP_2D_W256 = (1 << REG_GX_DISPCNT_OBJMAP_SHIFT + 1) | (0 << REG_GX_DISPCNT_EXOBJ_SHIFT + 2),
        GX_OBJVRAMMODE_BMP_1D_128K = (2 << REG_GX_DISPCNT_OBJMAP_SHIFT + 1) | (0 << REG_GX_DISPCNT_EXOBJ_SHIFT + 2),
        GX_OBJVRAMMODE_BMP_1D_256K = (2 << REG_GX_DISPCNT_OBJMAP_SHIFT + 1) | (1 << REG_GX_DISPCNT_EXOBJ_SHIFT + 2)
    }
    GXOBJVRamModeBmp;

    // OBSOLETE: These macros will be removed in the future release.
    #define GX_OBJVRAMMODE_BMP_2D_W128_32K GX_OBJVRAMMODE_BMP_2D_W128
    #define GX_OBJVRAMMODE_BMP_2D_W256_32K GX_OBJVRAMMODE_BMP_2D_W256

## 参照

GX_SetOBJVRamModeChar, GX_GetOBJVRamModeBmp

## 履歴

Ver. 2004/02/09

- 列挙型の値、`GX_OBJVRAMMODE_BMP_2D_W128_32K`と`GX_OBJVRAMMODE_BMP_2D_W256_32K`を`GX_OBJVRAMMODE_BMP_2D_W128`と`GX_OBJVRAMMODE_BMP_2D_W256`に変更。

Ver. 2004/01/19