NNS_G2dBGLoadElementsEx

# NNS_G2dBGLoadElements*

## 構文

      #include <nnsys/g2d/g2d_Screen.h>

      void NNS_G2dBGLoadElements(
          NNSG2dBGSelect bg,
          const NNSG2dScreenData* pScnData,
          const NNSG2dCharacterData* pChrData,
          const NNSG2dPaletteData* pPltData,
      );

      void NNS_G2dBGLoadElementsEx(
          NNSG2dBGSelect bg,
          const NNSG2dScreenData* pScnData,
          const NNSG2dCharacterData* pChrData,
          const NNSG2dPaletteData* pPltData,
          const NNSG2dCharacterPosInfo* pPosInfo,
          const NNSG2dPaletteCompressInfo* pCmpInfo
      );

## 引数

bg | [IN] ロードするデータを使用する BG 面
pScnData | [IN] スクリーンデータへのポインタ。pPltData が NULL の場合に限って NULL 指定も可能です。
pChrData | [IN] キャラクタデータへのポインタ。NULL 指定も可能です。
pPltData | [IN] パレットデータへのポインタ。NULL 指定も可能です。
pPosInfo | [IN] pChrData のキャラクタ抽出領域情報。pChrData が部分キャラクタでない場合は NULL を指定します。
pCmpInfo | [IN] pPltData のパレット圧縮情報。 pPltData が圧縮パレットでない場合は NULL を指定します。

## 返り値

なし。

## 説明

キャラクタ BG で用いるグラフィックスデータを適切なVRAMにロードします。 BG の設定状況からロード先を判断しますので、 BGモード と 対象 BG の BGControl が適切に設定されている必要があります。
この関数は BG 関連設定の変更を行いません。また、BMP BG には対応していません。

BG0 または BG1 の拡張パレットのロード先スロットは拡張パレットへの VRAM の割り当て状況から自動的に判断します。 テキスト BG の 256x1 パレットは拡張パレットが有効ならば拡張パレットへ そうでなければ標準パレットへロードします。

各パラメータに`NULL`が指定された場合は、 それぞれのグラフィックスデータの読み込みが行われません。 これは、グラフィックスデータを複数のBGで共有する場合の利用を想定しています。

この関数の実行結果は以下の設定の影響を受けます。 そのため、これらの設定は関数を呼び出す前に適切に設定しておかなければなりません。

- VRAM 割り当て
- ベースオフセット
- BG Control
- 表示モード
- BG モード

`NNSG2dBGSelect` 型については `NNS_G2dBGSetup()` を参照してください。

## 参照

`NNS_G2dBGSetup`

## 履歴

2004/09/02 初版