D3DXLoadVolumeFromVolume 関数

D3DXLoadVolumeFromVolume 関数

別のボリュームからボリュームをロードする。

構文

HRESULT D3DXLoadVolumeFromVolume(      
    LPDIRECT3DVOLUME9 pDestVolume,
    CONST PALETTEENTRY *pDestPalette,
    CONST D3DBOX *pDestBox,
    LPDIRECT3DVOLUME9 pSrcVolume,
    CONST PALETTEENTRY *pSrcPalette,
    CONST D3DBOX *pSrcBox,
    DWORD Filter,
    D3DCOLOR ColorKey
);

パラメータ

• pDestVolume
  [in] IDirect3DVolume9 インターフェイスへのポインタ。イメージを受け取る転送先のボリュームを指定する。
• pDestPalette
  [in] 256 色の転送先パレットである PALETTEENTRY 構造体へのポインタ、または NULL。
• pDestBox
  [in] D3DBOX 構造体へのポインタ。転送先のボックスを指定する。このパラメータに NULL を設定してボリューム全体を指定する。
• pSrcVolume
  [in] IDirect3DVolume9 インターフェイスへのポインタ。ソース ボリュームを指定する。
• pSrcPalette
  [in] 256 色の転送元パレットである PALETTEENTRY 構造体へのポインタ、または NULL。
• pSrcBox
  [in] D3DBOX 構造体へのポインタ。転送元のボックスを指定する。このパラメータに NULL を設定してボリューム全体を指定する。
• Filter
  [in] イメージをフィルタリングする方法を制御する 1 つあるいは複数の D3DX_FILTER の組み合わせ。このパラメータに D3DX_DEFAULT を指定することは、D3DX_FILTER_TRIANGLE | D3DX_FILTER_DITHER を指定することと等しい。
• ColorKey
  [in] 透明となる D3DCOLOR の値。カラー キーを無効にする場合は 0 を指定する。ソース イメージのフォーマットとは関係なく、これは常に 32 ビットの ARGB カラーである。アルファが有意であり、通常はカラー キーを不透明にする場合は FF を指定する。したがって、不透明な黒の場合、値は 0xFF000000 となる。

戻り値

成功した場合は、D3D_OK を返す。

失敗した場合は、次のいずれかの値を返す。

注意

ボリューム テクスチャのレベル ゼロ以外のサーフェイスに書き込んでも、ダーティー矩形は更新されない。D3DXLoadVolumeFromVolume を呼び出したときに、サーフェイスがまだダーティーでない (そのようなことは、通常の使用方法ではあり得ない) 場合、アプリケーションはサーフェイスに対して IDirect3DVolumeTexture9::AddDirtyBox を明示的に呼び出す必要がある。

関数の情報

参照

D3DXLoadVolumeFromFile、D3DXLoadVolumeFromFileInMemory、D3DXLoadVolumeFromMemory、D3DXLoadVolumeFromResource、テクスチャの色変換