D3DXCreateVolumeTextureFromFile 関数

D3DXCreateVolumeTextureFromFile 関数

ファイルを基にしてボリューム テクスチャを作成する。

構文

HRESULT D3DXCreateVolumeTextureFromFile(      
    LPDIRECT3DDEVICE9 pDevice,
    LPCTSTR pSrcFile,
    LPDIRECT3DVOLUMETEXTURE9 ppVolumeTexture
);

パラメータ

• pDevice
  [in] IDirect3DDevice9 インターフェイスへのポインタ。ボリューム テクスチャに関連付けられているデバイスを表す。
• pSrcFile
  [in] ファイル名を指定する文字列へのポインタ。コンパイラの設定が Unicode を要求している場合、データ タイプ LPCTSTR は LPCWSTR になる。それ以外の場合は、この文字列のデータ タイプは LPCSTR になる。「注意」を参照すること。
• ppVolumeTexture
  [out] 作成されたキューブ テクスチャ オブジェクトを表す、IDirect3DVolumeTexture9 インターフェイスへのポインタのアドレス。

戻り値

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

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

D3DERR_NOTAVAILABLE	このデバイスは、照会されたテクニックをサポートしていない。
D3DERR_OUTOFVIDEOMEMORY	Microsoft® Direct3D® が処理を行うのに十分なディスプレイ メモリがない。
D3DERR_INVALIDCALL	メソッドの呼び出しが無効である。たとえば、メソッドのパラメータに無効な値が設定されている場合などである。
D3DXERR_INVALIDDATA	データが無効である。
E_OUTOFMEMORY	Direct3D が呼び出しを完了するための十分なメモリを割り当てることができなかった。

注意

コンパイラの設定によって関数のバージョンも決まる。Unicode が定義されている場合、この関数の呼び出しは D3DXCreateVolumeTextureFromFileW になる。それ以外の場合は ANSI 文字列を使うので、この関数の呼び出しは D3DXCreateVolumeTextureFromFileA になる。

この関数がサポートしている ファイル フォーマットは、.bmp、.dds、.dib、.jpg、.png、および .tga である。

ミップマップされたテクスチャの各レベルには、ロードされたテクスチャが自動的に格納される。

ミップマップされたテクスチャにイメージをロードするとき、デバイスによっては、1x1 のイメージに変換できず、関数が失敗することがある。このような場合は、イメージを手動でロードする必要がある。

この関数を使用して作成したリソースは、D3DPOOL_MANAGED で示されるメモリ クラスに配置される。

関数の情報

ヘッダー	d3dx9tex.h
インポート ライブラリ	d3dx9.lib
最低限のオペレーティング システム	Windows 98

参照

D3DXCreateVolumeTextureFromFileEx, D3DXCreateVolumeTextureFromFileInMemory、D3DXCreateVolumeTextureFromFileInMemoryEx、D3DXCreateVolumeTextureFromResource、D3DXCreateVolumeTextureFromResourceEx、テクスチャの色変換