D3DXCreateCubeTextureFromFileInMemory
メモリーにロードされたファイルを元にキューブ テクスチャーを作成します。
HRESULT
D3DXCreateCubeTextureFromFileInMemory(
LPDIRECT3DDEVICE9 pDevice,
LPCVOID pSrcData,
UINT SrcDataSize,
LPDIRECT3DCUBETEXTURE9 * ppCubeTexture
);
パラメータ
- pDevice
IDirect3DDevice9 インターフェイスへのポインターです。キューブ テクスチャーに関連付けられるデバイスを示します。 - pSrcData
キューブマップの作成に使用するメモリー内のファイルへのポインターです。「解説」を参照してください。 - SrcDataSize
メモリー内のサイズ (バイト単位) です。 - ppCubeTexture
作成されたキューブ テクスチャー オブジェクトを表す IDirect3DCubeTexture9 インターフェイスへのポインターのアドレスです。
戻り値
成功すると、D3D_OK を返します。失敗した場合は、次の戻り値のいずれかを返します。D3DERR_INVALIDCALL
D3DERR_NOTAVAILABLED3DERR_OUTOFVIDEOMEMORYD3DXERR_INVALIDDATAE_OUTOFMEMORY
解説
この関数は、.bmp、.dds、.dib、.hdr、.jpg、.pfm、.png、.ppm、および .tga ファイル形式をサポートします。「D3DXIMAGE_FILEFORMAT」を参照してください。
この関数は D3DXCreateCubeTextureFromFileInMemoryEx(pDevice, pSrcData, SrcDataSize, D3DX_DEFAULT, D3DX_DEFAULT, 0, D3DFMT_UNKNOWN, D3DPOOL_MANAGED, D3DX_DEFAULT, D3DX_DEFAULT, 0, NULL, NULL, ppCubeTexture) と同等です。
IDirect3DDevice9 オブジェクトからこの関数を呼び出してリソースを作成すると、そのリソースは D3DPOOL_MANAGED が示すメモリー クラスに格納されます。IDirect3DDevice9Ex オブジェクトからこのメソッドを呼び出した場合、作成したリソースは D3DPOOL_DEFAULT が示すメモリー クラスに配置されます。
このメソッドは、アプリケーション定義リソース (未処理のデータ) の RT_RCDATA として格納されているイメージ ファイルのロードに使用します。他の種類のファイルに対して使用すると、このメソッドは失敗します。
このメソッドを使用して作成したテクスチャーには、自動的にフィルタリングが適用されます。このフィルタリングは D3DX_FILTER の D3DX_FILTER_TRIANGLE | D3DX_FILTER_DITHER と同等です。
D3DXCreateCubeTextureFromFileInMemory は DirectDraw サーフェス (DDS) ファイル フォーマットを使用します。DirectX テクスチャー エディター (Dxtex.exe) を使用すると、他のファイル形式からキューブ マップを生成し、DDS ファイル形式で保存できます。
要件
ヘッダー: D3dx9tex.h 宣言
ライブラリ: D3dx9.lib 内容