D3DXLoadVolumeFromFile 関数

  • [アーティクル]

ファイルからボリュームを読み込みます。

構文

HRESULT D3DXLoadVolumeFromFile(
  _In_       LPDIRECT3DVOLUME9 pDestVolume,
  _In_ const PALETTEENTRY      *pDestPalette,
  _In_ const D3DBOX            *pDestBox,
  _In_       LPCTSTR           pSrcFile,
  _In_ const D3DBOX            *pSrcBox,
  _In_       DWORD             Filter,
  _In_       D3DCOLOR          ColorKey,
  _In_       D3DXIMAGE_INFO    *pSrcInfo
);

パラメーター

pDestVolume [in]

種類: LPDIRECT3DVOLUME9

IDirect3DVolume9 インターフェイスへのポインター。 宛先ボリュームを指定します。

pDestPalette [in]

型: const PALETTEENTRY*

PALETTEENTRY 構造体 (256 色または NULL のコピー先パレット) へのポインター。

pDestBox [in]

型: const D3DBOX*

D3DBOX 構造体へのポインター。 コピー先のボックスを指定します。 ボリューム全体を指定するには、このパラメーターを NULL に設定します。

pSrcFile [in]

種類: LPCTSTR

ファイル名を指定する文字列へのポインター。 コンパイラ設定で Unicode が必要な場合、データ型 LPCTSTR は LPCWSTR に解決されます。 それ以外の場合、文字列データ型は LPCSTR に解決されます。 「解説」を参照してください。

pSrcBox [in]

型: const D3DBOX*

D3DBOX 構造体へのポインター。 ソース ボックスを指定します。 ボリューム全体を指定するには、このパラメーターを NULL に設定します。

フィルター [入力]

型: DWORD

1 つ以上の D3DX_FILTERの組み合わせで、イメージのフィルター処理方法を制御します。 このパラメーターにD3DX_DEFAULTを指定することは、D3DX_FILTER_TRIANGLE |D3DX_FILTER_DITHER。

ColorKey [in]

種類: D3DCOLOR

透明な黒に置き換える D3DCOLOR 値、またはカラーキーを無効にする場合は 0。 これは、ソース イメージ形式とは無関係に、常に 32 ビットの ARGB 色です。 アルファは重要であり、通常、不透明な色キーの場合は FF に設定する必要があります。 したがって、不透明な黒の場合、値は0xFF000000と等しくなります。

pSrcInfo [in]

種類: D3DXIMAGE_INFO*

ソース イメージ ファイル内のデータの説明が入力される D3DXIMAGE_INFO 構造体へのポインター( NULL)。

戻り値

型: HRESULT

関数が成功した場合、戻り値はD3D_OK。 関数が失敗した場合、戻り値には次のいずれかの値を指定できます:D3DERR_INVALIDCALL、D3DXERR_INVALIDDATA。

注釈

コンパイラ設定によって、関数のバージョンも決定されます。 Unicode が定義されている場合、関数呼び出しは D3DXLoadVolumeFromFileW に解決されます。 それ以外の場合、ANSI 文字列が使用されているため、関数呼び出しは D3DXLoadVolumeFromFileA に解決されます。

この関数は、圧縮テクスチャ形式との間の変換を処理し、.bmp、.dds、.dib、.hdr、.jpg、.pfm、.png、.ppm、および .tga のファイル形式をサポートします。 「D3DXIMAGE_FILEFORMAT」を参照してください。

ボリューム テクスチャのレベル 0 以外のサーフェスに書き込んだ場合、ダーティ四角形は更新されません。 D3DXLoadVolumeFromFile が呼び出され、テクスチャがまだダーティされていない場合 (通常の使用シナリオではそうはいかない)、アプリケーションはボリューム テクスチャで IDirect3DVolumeTexture9::AddDirtyBox を明示的に呼び出す必要があります。

要件

要件 値
ヘッダー
D3dx9tex.h
ライブラリ
D3dx9.lib

こちらもご覧ください

D3DXLoadVolumeFromFileInMemory

D3DXLoadVolumeFromMemory

D3DXLoadVolumeFromResource

D3DXLoadVolumeFromVolume

D3DX 9 のテクスチャ関数