グラフィックス(GX/G2/G2Util/G3/G3Util/G3X)API 機能一覧

2D/3Dグラフィックス全般(GX)

パワーコントロール

GX_Power 各種パワーコントロールを一括設定します。
GX_PowerLCD LCDパワーのON/OFFを設定します。
GX_Power2D 2DグラフィックスエンジンのON/OFFを設定します。
GX_PowerGeometry ジオメトリエンジンのON/OFFを設定します。
GX_PowerRender レンダリングエンジンのON/OFFを設定します。

初期化

GX_Init グラフィックスシステムを初期化します。

表示モードとBGモードの設定

GX_SetGraphicsMode 表示モードとBGモードを設定します。

表示・非表示の設定

GX_SetVisiblePlane BG, OBJの表示/非表示を選択します。
GX_SetVisibleWindow ウィンドウの表示/非表示を選択します。
GX_BlankScreen LCD表示の無効/有効を設定します。

オフセットの設定

GX_SetBGScreenOffset スクリーンオフセットを設定します。
GX_SetBGCharOffset キャラクタオフセットを設定します。

OBJマッピングモードの設定

GX_SetCharOBJMemoryMode キャラクタOBJのマッピングモードを設定します。
GX_SetBitmapOBJMemoryMode ビットマップOBJのマッピングモードを設定します。

VRAMバンクのリソースへの割り当て

GX_SetBankForBG VRAMバンクを指定してBGに割り当てます。
GX_SetBankForOBJ VRAMバンクを指定してOBJに割り当てます。
GX_SetBankForBGEXTPLTT VRAMバンクを指定してBG拡張パレットに割り当てます。
GX_SetBankForOBJEXTPLTT VRAMバンクを指定してOBJ拡張パレットにに割り当てます。
GX_SetBankForTEX VRAMバンクを指定してテクスチャイメージスロットに割り当てます。
GX_SetBankForTEXPLTT VRAMバンクを指定してテクスチャパレットスロットに割り当てます。
GX_SetBankForCLRIMG VRAMバンクを指定してクリアイメージに割り当てます。
GX_SetBankForARM7 VRAMバンクを指定してARM7メモリ空間に割り当てます。
GX_SetBankForLCDC VRAMバンクを指定してLCDCメモリ空間に割り当てます。

リソースに割り当てられたVRAMバンクのLCDCメモリ空間への切り替え

GX_ResetBankForBG BGに割り当てられたVRAMバンクをLCDCメモリ空間に割り当てます。
GX_ResetBankForOBJ OBJに割り当てられたVRAMバンクをLCDCメモリ空間に割り当てます。
GX_ResetBankForBGEXTPLTT BGEXTPLTTに割り当てられたVRAMバンクをLCDCメモリ空間に割り当てます。
GX_ResetBankForOBJEXTPLTT OBJEXTPLTTに割り当てられたVRAMバンクをLCDCメモリ空間に割り当てます。
GX_ResetBankForTEX TEXに割り当てられたVRAMバンクをLCDCメモリ空間に割り当てます。
GX_ResetBankForTEXPLTT TEXPLTTに割り当てられたVRAMバンクをLCDCメモリ空間に割り当てます。
GX_ResetBankForCLRIMG CLRIMGに割り当てられたVRAMバンクをLCDCメモリ空間に割り当てます。
GX_ResetBankForARM7 ARM7に割り当てられたVRAMバンクをLCDCメモリ空間に割り当てます。

リソースに割り当てられたVRAMバンクの解除

GX_DisableBankForBG BGに割り当てられたVRAMバンクを無効にします。
GX_DisableBankForOBJ OBJに割り当てられたVRAMバンクを無効にします。
GX_DisableBankForBGEXTPLTT BGEXTPLTTに割り当てられたVRAMバンクを無効にします。
GX_DisableBankForOBJEXTPLTT OBJEXTPLTTに割り当てられたVRAMバンクを無効にします。
GX_DisableBankForTEX TEXに割り当てられたVRAMバンクを無効にします。
GX_DisableBankForTEXPLTT TEXPLTTに割り当てられたVRAMバンクを無効にします。
GX_DisableBankForCLRIMG CLRIMGに割り当てられたVRAMバンクを無効にします。
GX_DisableBankForARM7 ARM7に割り当てられたVRAMバンクを無効にします。
GX_DisableBankForLCDC LCDCに割り当てられたVRAMバンクを無効にします。

WRAMのバンク割り当て

GX_SetWRAMBank ワークRAMをARM9とARM7のどちらに割り当てるか選択します

割り込み・その他

GX_Capture 画面キャプチャを設定します。
GX_SetMasterBrightness マスター輝度を設定します。
GX_GetVCount Vカウンタ値を読み出します。
GX_SetVCount Vカウンタ値を書き出します。
GX_IsHBlank Hブランク期間中かをテストします。
GX_IsVBlank Vブランク期間中かをテストします。
GX_IsVCounter Vカウンター一致期間中かをテストします。
GX_IsHBlankIntrEnable Hブランク割り込みが許可されているかをテストします。
GX_IsVBlankIntrEnable Vブランク割り込みが許可されているかをテストします。
GX_VCounterIntr Vカウンター一致割り込みを許可/不許可に設定します。
GX_HBlankIntr Hブランク割り込みを許可/不許可に設定します。
GX_VBlankIntr Vブランク割り込みを許可/不許可に設定します。

2Dグラフィックス(G2)

BGコントロール

G2_SetBG0Control BG0の各種コントロールを設定します。
G2_SetBG1Control BG1の各種コントロールを設定します。
G2_SetBG2ControlText BG2の各種コントロール(テキストモードの場合)を設定します。
G2_SetBG2ControlAffine BG2の各種コントロール(アフィンモードの場合)を設定します。
G2_SetBG2ControlExt256x16Pltt BG2の各種コントロール(256x16パレットキャラクタBGの場合)を設定します。
G2_SetBG2ControlExt256Bmp BG2の各種コントロール(256ビットマップBGの場合)を設定します。
G2_SetBG2ControlExtDCBmp BG2の各種コントロール(ダイレクトカラービットマップBGの場合)を設定します。
G2_SetBG3ControlText BG3の各種コントロール(テキストモードの場合)を設定します。
G2_SetBG3ControlAffine BG3の各種コントロール(アフィンモードの場合)を設定します。
G2_SetBG3ControlExt256x16Pltt BG3の各種コントロール(256x16パレットキャラクタBGの場合)を設定します。
G2_SetBG3ControlExt256Bmp BG3の各種コントロール(256ビットマップBGの場合)を設定します。
G2_SetBG3ControlExtDCBmp BG3の各種コントロール(ダイレクトカラービットマップBGの場合)を設定します。

BGの表示優先度の設定

G2_BG0ControlPriority BG0の表示優先度を設定します。
G2_BG1ControlPriority BG1の表示優先度を設定します。
G2_BG2ControlPriority BG2の表示優先度を設定します。
G2_BG3ControlPriority BG3の表示優先度を設定します。

BGのモザイク適用/不適用の設定

G2_BG0ControlMosaic BG0のモザイク適用/不適用を設定します。
G2_BG1ControlMosaic BG1のモザイク適用/不適用を設定します。
G2_BG2ControlMosaic BG2のモザイク適用/不適用を設定します。
G2_BG3ControlMosaic BG3のモザイク適用/不適用を設定します。

ポインタの取得

G2_GetBG0ScreenPtr BG0のスクリーンベースへのポインタを返します。
G2_GetBG1ScreenPtr BG1のスクリーンベースへのポインタを返します。
G2_GetBG2ScreenPtr BG2のスクリーンベースへのポインタを返します。
G2_GetBG3ScreenPtr BG3のスクリーンベースへのポインタを返します。
G2_GetBG0CharPtr BG0のキャラクタベースへのポインタを返します。
G2_GetBG1CharPtr BG1のキャラクタベースへのポインタを返します。
G2_GetBG2CharPtr BG2のキャラクタベースへのポインタを返します。
G2_GetBG3CharPtr BG3のキャラクタベースへのポインタを返します。
G2_GetOBJCharPtr OBJのキャラクタベースへのポインタを返します。

BG平面のオフセットの設定

G2_SetBG0Offset BG0平面のオフセットを設定します。
G2_SetBG1Offset BG1平面のオフセットを設定します。
G2_SetBG2Offset BG2平面のオフセットを設定します。
G2_SetBG3Offset BG3平面のオフセットを設定します。

BG平面のアフィン変換の設定

G2_SetBG2Affine BG2平面に適用されるアフィン変換を設定します。
G2_SetBG3Affine BG3平面に適用されるアフィン変換を設定します。

ウィンドウの設定

G2_SetWindow0InsidePlane ウィンドウ0の内側にくる平面の設定を行います。
G2_SetWindow1InsidePlane ウィンドウ1の内側にくる平面の設定を行います。
G2_SetWindowOutsidePlane ウィンドウの外側にくる平面の設定を行います。
G2_SetOBJWindowInsidePlane OBJウィンドウの内側にくる平面の設定を行います。
G2_SetWindow0Position ウィンドウ0の位置設定をします。
G2_SetWindow1Position ウィンドウ1の位置設定をします。

モザイク

G2_SetBGMosaicSize BGにかかるモザイクサイズを設定します。
G2_SetOBJMosaicSize OBJにかかるモザイクサイズを設定します。

カラー特殊効果

G2_SetBlendNone カラー特殊効果を行わないよう設定します。
G2_SetBlendAlphaOBJAnd3D OBJと3Dに対してのみαブレンディングを行います。
G2_SetBlendAlpha αブレンディングを行います。
G2_SetBlendBrightness 輝度のコントロールを行います。
G2_SetBlendBrightnessAndAlphaOBJAnd3D 輝度のコントロールを行い、OBJと3Dに対してはαブレンディングを行います。
G2_SetBlendAlphaParam αブレンディングの係数を設定します。
G2_SetBlendBrightnessParam 輝度変更係数を設定します。

OAM

G2_SetOBJAttribute オブジェクトの各アトリビュートを設定します。
G2_SetOBJAffine オブジェクトのアフィン変換を設定します。
G2_SetOBJXY オブジェクトのXY座標を設定します。
G2_SetOBJPriority オブジェクトの表示優先度を設定します。
G2_SetOBJMode オブジェクトのOBJモードを設定します。
G2_SetOBJEffect オブジェクトのフリップ/アフィン変換パラメータを設定します。
G2_SetOBJShape オブジェクトの形状を設定します。
G2_SetOBJCharName オブジェクトの先頭キャラクタネームを設定します。

2Dグラフィックスユーティリティ(G2Util)

各種リソースのロード

G2Util_LoadOBJ OBJデータを2DグラフィックエンジンのOBJに転送します。
G2Util_LoadOAM OAMデータをOAMに転送します。
G2Util_LoadBGPltt 標準BGパレットデータを標準BGパレットRAMに転送します。
G2Util_LoadOBJPltt 標準OBJパレットデータを標準OBJパレットRAMに転送します。
G2Util_LoadBG0Screen BG0スクリーンにデータを転送します。
G2Util_LoadBG1Screen BG1スクリーンにデータを転送します。
G2Util_LoadBG2Screen BG2スクリーンにデータを転送します。
G2Util_LoadBG3Screen BG3スクリーンにデータを転送します。
G2Util_LoadBG0Char BG0キャラクタにデータを転送します。
G2Util_LoadBG1Char BG1キャラクタにデータを転送します。
G2Util_LoadBG2Char BG2キャラクタにデータを転送します。
G2Util_LoadBG3Char BG3キャラクタにデータを転送します。
G2Util_BeginLoadBGExtPltt BG拡張パレットにデータを転送する前に呼びます。
G2Util_LoadBGExtPltt BG拡張パレットにデータを転送します。
G2Util_EndLoadBGExtPltt BG拡張パレットへのデータを転送が全て終った後に呼びます。
G2Util_BeginLoadOBJExtPltt OBJ拡張パレットにデータを転送する前に呼びます。
G2Util_LoadOBJExtPltt OBJ拡張パレットにデータを転送します。
G2Util_EndLoadOBJExtPltt OBJ拡張パレットへのデータ転送が全て終った後に呼びます。

3Dジオメトリ(G3*)

ジオメトリと頂点

G3*_Begin 頂点リストの開始を宣言します。
G3*_End 頂点リストの終了を宣言します。
G3*_Vertex 頂点座標を設定します。
G3*_VertexShort 頂点座標を設定します。
G3*_VertexXY 頂点のXY座標を設定します。
G3*_VertexXZ 頂点のXZ座標を設定します。
G3*_VertexYZ 頂点のYZ座標を設定します。
G3*_VertexDiff 頂点座標を最後に設定したデータの差分値で指定します。
G3*_Normal 法線ベクトルを設定します。
G3*_Color 頂点カラーを直接設定します。
G3*_TexCoord テクスチャ座標を設定します。
G3*_TexCoordImm テクスチャ座標を設定します。
G3*_PolygonAttr ポリゴン関連属性値を設定します。

行列とビューポート

G3*_MtxMode 行列モードを設定します。
G3*_Identity カレント行列を単位行列に初期化します。
G3*_LoadMtx43 カレント行列に4x3行列を設定します。
G3*_LoadMtx44 カレント行列に4x4行列を設定します。
G3*_MultMtx43 カレント行列に4x3行列を乗算します。
G3*_MultMtx44 カレント行列に4x4行列を乗算します。
G3*_MultMtx33 カレント行列に3x3行列を乗算します。
G3*_PushMtx カレント行列をスタックへプッシュします。
G3*_PopMtx カレント行列をスタックからポップします。
G3*_StoreMtx カレント行列をスタックの指定位置に格納します。
G3*_RestoreMtx スタックの指定位置から行列を読み出します。
G3*_Scale カレント行列にスケール(拡大縮小)行列を乗算します。
G3*_Translate カレント行列に平行移動行列を乗算します。
G3*_ViewPort ビューポートを設定します。

ライティング

G3*_LightColor ライトカラーを設定します。
G3*_LightVector ライトの方向ベクトルを設定します。
G3*_MaterialColorDiffAmb 材質の拡散反射色と環境反射色を設定します。
G3*_MaterialColorSpecEmi 材質の鏡面反射色と放射光色を設定します。
G3*_Shininess 鏡面反射輝度テーブルを設定します。

テクスチャ

G3*_TexImageParam テクスチャのパラメータを設定します。
G3*_TexPlttBase テクスチャパレットのベースアドレスを設定します。
G3*_TexPlttBaseImm テクスチャパレットのベースアドレスを設定します。

コントロール

G3*_SwapBuffers レンダリングエンジンが参照するデータ群をスワップします。
G3*_Nop 何もしません。

ジオメトリ可視判定

G3_BoxTest 関数の説明をここに書きます。
G3_PositionTest 関数の説明をここに書きます。
G3_VectorTest 関数の説明をここに書きます。

3Dグラフィックス制御(G3X)

初期化

G3X_Init 3D関係各種の初期化をします。
G3X_InitTables Fogテーブル等の初期化をします。
G3X_InitMtxStack 行列スタックの初期化をします。
G3X_Reset オーバーフロー等のリセットをします。普通各フレーム描画処理の最初に実行します。
G3X_ResetMtxStack 行列スタックの初期化をしますが、プロジェクション行列には単位行列を代入しません。

各種機能の有効/無効

G3X_AlphaTest αテストの設定を行います。
G3X_AlphaBlend αブレンドを有効/無効を選択します。
G3X_AntiAlias アンチエイリアスの有効/無効を選択します。

トゥーン/ハイライトシェーディング

G3X_Shading トゥーン/ハイライトシェーディングを選択します。
G3X_SetToonTable トゥーン/ハイライトテーブルを設定します。

エッジカラー

G3X_EdgeMarking エッジマーキングの有効/無効を選択します。
G3X_SetEdgeColorTable エッジカラーテーブルの設定を行います。

フォグ

G3X_Fog フォグの設定を行います。
G3X_SetFogColor フォグカラーの設定を行います。
G3X_SetFogTable フォグテーブルの設定を行います。

オフセットの設定

G3X_SetBG0Offset BG0平面のオフセットを設定します。
G3X_SetClearImageOffset クリアイメージを使用する場合のオフセットを設定します。

クリアカラーとクリアデプス

G3X_SetClearColor クリアカラーを設定します。
G3X_SetClearDepth クリアデプスを設定します。

テスト結果・演算結果の取得

G3X_GetBoxTestResult ボックステストの結果を取得します。
G3X_GetPositionTestResult ポジションテストの結果を取得します。
G3X_GetVectorTestResult ベクトルテストの結果を取得します。
G3X_GetClipMtx カレントクリップ座標行列を取得します。
G3X_GetVectorMtx カレント方向ベクトル行列を取得します。

その他

G3X_GetMtxStackLevelPV PositionVector行列スタックのレベルを取得します。
G3X_GetMtxStackLevelPJ Projection行列スタックのレベルを取得します。
G3X_IsGeometryBusy ジオメトリがビジーであるかどうかをテストします。
G3X_SetFIFOIntrCond コマンドFIFO割り込み要求発生条件を設定します。
G3X_SetDisp1DotDepth 1ドットポリゴン表示境界デプス値レジスタの値を設定します。
G3X_GetG3XMiscStatus その他各種状態をまとめて取得します。
G3X_SetG3XMiscStatus その他各種状態をまとめて書き込みます。

3Dグラフィックスユーティリティ(G3Util)

行列

G3Util_Frustum カレントProjection行列に設定します。
G3Util_Perspective カレントProjection行列に設定します。
G3Util_Ortho カレントProjection行列に設定します。
G3Util_LookAt カレントPosition/Vector行列に設定します。
G3Util_RotX カレントPosition/Vector行列にX軸に関する回転行列を乗じます。
G3Util_RotY カレントPosition/Vector行列にY軸に関する回転行列を乗じます。
G3Util_RotZ カレントPosition/Vector行列にZ軸に関する回転行列を乗じます。
G3Util_LoadTextureMtx カレントTexture行列にテクスチャ行列向けの補正を行った行列を設定します。

各種リソースのロード

G3Util_BeginLoadTexture テクスチャイメージスロットにデータを転送する前に呼びます。
G3Util_LoadTexture テクスチャイメージスロットにデータを転送します。
G3Util_EndLoadTexture テクスチャイメージスロットにデータを転送が全て終った後に呼びます。
G3Util_BeginLoadTexturePltt テクスチャパレットスロットにデータを転送する前に呼びます。
G3Util_LoadTexturePltt テクスチャパレットスロットにデータを転送します。
G3Util_EndLoadTexturePltt テクスチャパレットスロットにデータを転送が全て終った後に呼びます。
G3Util_BeginLoadClearImage クリアイメージスロットにデータを転送する前に呼びます。
G3Util_LoadClearImageColor クリアイメージスロットにカラーデータを転送します。
G3Util_LoadClearImageDepth クリアイメージスロットにデプスデータを転送します。
G3Util_EndLoadClearImage クリアイメージスロットにデータを転送が全て終った後に呼びます。
グラフィックスAPI 機能一覧