D3DXCreateVolumeTextureFromFile 関数
ファイルからボリューム テクスチャを作成します。
構文
HRESULT D3DXCreateVolumeTextureFromFile(
_In_ LPDIRECT3DDEVICE9 pDevice,
_In_ LPCTSTR pSrcFile,
_Out_ LPDIRECT3DVOLUMETEXTURE9 *ppVolumeTexture
);
パラメーター
-
pDevice [in]
-
ボリューム テクスチャに関連付けるデバイスを表す IDirect3DDevice9 インターフェイスへのポインター。
-
pSrcFile [in]
-
型: LPCTSTR
ファイル名を指定する文字列へのポインター。 コンパイラ設定で Unicode が必要な場合、データ型 LPCTSTR は LPCWSTR に解決されます。 それ以外の場合、文字列データ型は LPCSTR に解決されます。 「解説」を参照してください。
-
ppVolumeTexture [out]
-
作成されたテクスチャ オブジェクトを表す IDirect3DVolumeTexture9 インターフェイスへのポインターのアドレス。
戻り値
種類: HRESULT
関数が成功した場合、戻り値はD3D_OK。 関数が失敗した場合、戻り値は、D3DERR_NOTAVAILABLE、D3DERR_OUTOFVIDEOMEMORY、D3DERR_INVALIDCALL、D3DXERR_INVALIDDATA、E_OUTOFMEMORYのいずれかになります。
注釈
コンパイラ設定によって、関数のバージョンも決定されます。 Unicode が定義されている場合、関数呼び出しは D3DXCreateVolumeTextureFromFileW に解決されます。 それ以外の場合、ANSI 文字列が使用されているため、関数呼び出しは D3DXCreateVolumeTextureFromFileA に解決されます。
この関数は D3DXCreateVolumeTextureFromFileEx(pDevice, pSrcFile, D3DX_DEFAULT, D3DX_DEFAULT, D3DX_DEFAULT, D3DX_DEFAULT, 0, D3DFMT_UNKNOWN, D3DPOOL_MANAGED, D3DX_DEFAULT, D3DX_DEFAULT, 0, NULL, NULL, ppVolumeTexture) と同じです。
この関数は、.bmp、.dds、.dib、.hdr、.jpg、.pfm、.png、.ppm、.tga のファイル形式をサポートします。 「D3DXIMAGE_FILEFORMAT」を参照してください。
Mipmapped テクスチャでは、読み込まれたテクスチャで各レベルが自動的に塗りつぶされます。
mipmapped テクスチャにイメージを読み込むとき、一部のデバイスは 1x1 イメージに移動できず、この関数は失敗します。 このような場合は、イメージを手動で読み込む必要があります。
IDirect3DDevice9 オブジェクトから呼び出されたときにこの関数で作成されたリソースは、D3DPOOL_MANAGEDで示されるメモリ クラスに配置されることに注意してください。 このメソッドが IDirect3DDevice9Ex オブジェクトから呼び出されると、リソースは D3DPOOL_DEFAULT で示されるメモリ クラスに配置されます。
フィルター処理は、このメソッドを使用して作成されたテクスチャに自動的に適用されます。 フィルター処理は、D3DX_FILTER_TRIANGLE |D3DX_FILTERで D3DX_FILTER_DITHER。
要件
| 要件 | 値 |
|---|---|
| ヘッダー |
|
| ライブラリ |
|
こちらもご覧ください