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)