D3DXCreateCubeTextureFromFileInMemory 関数

メモリ内のファイルからキューブ テクスチャを作成します。

構文

HRESULT D3DXCreateCubeTextureFromFileInMemory(
  _In_  LPDIRECT3DDEVICE9      pDevice,
  _In_  LPCVOID                pSrcData,
  _In_  UINT                   SrcDataSize,
  _Out_ LPDIRECT3DCUBETEXTURE9 *ppCubeTexture
);

パラメーター

pDevice [in]

種類: LPDIRECT3DDEVICE9

キューブ テクスチャに関連付けられるデバイスを表す IDirect3DDevice9 インターフェイスへのポインター。

pSrcData [in]

種類: LPCVOID

キューブマップの作成元となるメモリ内のファイルへのポインター。 「解説」を参照してください。

SrcDataSize [in]

型: UINT

メモリ内のファイルのサイズ (バイト単位)。

ppCubeTexture [out]

種類: LPDIRECT3DCUBETEXTURE9*

作成されたキューブ テクスチャ オブジェクトを表す IDirect3DCubeTexture9 インターフェイスへのポインターのアドレス。

戻り値

型: HRESULT

関数が成功した場合、戻り値はD3D_OK。 関数が失敗した場合、戻り値は、D3DERR_INVALIDCALL、D3DERR_NOTAVAILABLE、D3DERR_OUTOFVIDEOMEMORY、D3DXERR_INVALIDDATA、E_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_TRIANGLE |D3DX_FILTERで D3DX_FILTER_DITHERします。

D3DXCreateCubeTextureFromFileInMemory では、DirectDraw サーフェス (DDS) ファイル形式が使用されます。 DirectX テクスチャ エディター (Dxtex.exe) を使用すると、他のファイル形式からキューブ マップを生成し、DDS ファイル形式で保存できます。 Dxtex.exeを取得し、DirectX SDK から学習できます。 DirectX SDK の詳細については、「 DirectX SDK はどこにありますか?」を参照してください。

要件

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

関連項目

D3DX 9 のテクスチャ関数