D3DXCreateCubeTextureFromResource
リソースからキューブ テクスチャーを作成します。
HRESULT
D3DXCreateCubeTextureFromResource(
LPDIRECT3DDEVICE9 pDevice,
HMODULE hSrcModule,
LPCTSTR pSrcResource,
LPDIRECT3DCUBETEXTURE9 * ppCubeTexture
);
パラメータ
- pDevice
IDirect3DDevice9 インターフェイスへのポインターです。キューブ テクスチャーに関連付けられるデバイスを示します。 - hSrcModule
リソースが存在するモジュールのハンドルです。現在のプロセスの作成に使用されたオペレーティング システムにイメージに関連付けられたモジュールの場合は、NULL です。 - pSrcResource
リソース名を指定する文字列へのポインターです。コンパイラーの設定で Unicode が必要な場合、データ型 LPCTSTR は LPCWSTR に解決されます。それ以外の場合、文字列データ型は LPCSTR に解決されます。「解説」を参照してください。 - ppCubeTexture
作成されたキューブ テクスチャー オブジェクトを表す IDirect3DCubeTexture9 インターフェイスへのポインターのアドレスです。
戻り値
成功すると、D3D_OK を返します。失敗した場合は、次のいずれかの値を返します。D3DERR_INVALIDCALL
D3DERR_NOTAVAILABLED3DERR_OUTOFVIDEOMEMORYD3DXERR_INVALIDDATAE_OUTOFMEMORY
解説
コンパイラ設定により、関数のバージョンが決定されます。Unicode が定義されている場合、関数呼び出しは D3DXCreateCubeTextureFromResourceW に解決されます。それ以外の場合は、ANSI 文字列が使用されるため、D3DXCreateCubeTextureFromResourceA に解決されます。
この関数は D3DXCreateCubeTextureFromResourceEx(pDevice, hSrcModule, pSrcResource, D3DX_DEFAULT, D3DX_DEFAULT, 0, D3DFMT_UNKNOWN, D3DPOOL_MANAGED, D3DX_DEFAULT, D3DX_DEFAULT, 0, NULL, NULL, ppCubeTexture) と同等です。
この関数は、.bmp、.dds、.dib、.hdr、.jpg、.pfm、.png、.ppm、および .tga ファイル形式をサポートします。「D3DXIMAGE_FILEFORMAT」を参照してください。
IDirect3DDevice9 オブジェクトからこの関数を呼び出してリソースを作成すると、そのリソースは D3DPOOL_MANAGED が示すメモリー クラスに格納されます。IDirect3DDevice9Ex オブジェクトからこのメソッドを呼び出した場合、作成したリソースは D3DPOOL_DEFAULT が示すメモリー クラスに配置されます。
このメソッドを使用して作成したテクスチャーには、自動的にフィルタリングが適用されます。このフィルタリングは D3DX_FILTER の D3DX_FILTER_TRIANGLE | D3DX_FILTER_DITHER と同等です。
D3DXCreateCubeTextureFromResource は DirectDraw サーフェス (DDS) ファイル フォーマットを使用します。DirectX テクスチャー エディター (Dxtex.exe) を使用すると、他のファイル形式からキューブ マップを生成し、DDS ファイル形式で保存できます。
要件
ヘッダー: D3dx9tex.h 宣言
ライブラリ: D3dx9.lib 内容