IDirect3DDevice9::SetPaletteEntries
パレットのエントリを設定します。
HRESULT
SetPaletteEntries(
UINT PaletteNumber,
CONST PALETTEENTRY * pEntries
);
パラメータ
- PaletteNumber
操作を実行する特定のパレットを識別する序数値です。 - pEntries
設定するパレット エントリを表す PALETTEENTRY 構造体へのポインターです。pEntries でポイントされる PALETTEENTRY 構造体の数は 256 を前提としています。「解説」を参照してください。
戻り値
メソッドが成功した場合は、D3D_OK を返します。失敗した場合は、D3DERR_INVALIDCALL を返します。
解説
Direct3D 9 アプリケーションでは、このメソッドで指定される任意のパレットは D3DCAPS9 構造体の D3DPTEXTURECAPS_ALPHAPALETTE 能力ビットに適合する必要があります。D3DPTEXTURECAPS_ALPHAPALETTE を設定しない場合、パレットのすべてのエントリは 1.0 に設定されたアルファを持つ必要があります。そうでない場合、このメソッドは D3DERR_INVALIDCALL で失敗します。D3DPTEXTURECAPS_ALPHAPALETTE を設定した場合は、アルファ値の任意のセットを使用できます。すべてのパレット エントリが 0 に設定されたアルファを持つ場合、デバッグ ランタイムで警告メッセージが出力されます。
1 つの論理パレットがデバイスに関連付けられ、すべてのテクスチャー ステージにより共有されます。
要件
ヘッダー: D3D9.h 宣言
ライブラリ: D3D9.lib 内容
関連項目
IDirect3DDevice9::GetCurrentTexturePalette, IDirect3DDevice9::GetPaletteEntries, IDirect3DDevice9::SetCurrentTexturePalette, テクスチャー パレット (Direct3D 9)