Microsoft DirectX 8.0 (C++)

D3DXCreateCubeTextureFromFileW

Unicode 文字列で指定されたファイルからキューブ テクスチャを作成する。

D3DXCreateCubeTextureFromFile は、#define UNICODE スイッチが含まれているかどうかに応じて、D3DXCreateCubeTextureFromFileA または D3DXCreateCubeTextureFromFileW のどちらかをマップする。

HRESULT D3DXCreateCubeTextureFromFileW(
  LPDIRECT3DDEVICE8 pDevice,
  LPCWSTR pSrcFile,
  LPDIRECT3DCUBETEXTURE8* ppCubeTexture
);

パラメータ

pDevice
[in] キューブ テクスチャに関連付けられるデバイスを表す IDirect3DDevice8 インターフェイスへのポインタ。
pSrcFile
[in] キューブ テクスチャの作成に使用するファイルを指定する Unicode 文字列へのポインタ。「注意」を参照すること。
ppCubeTexture
[out] 作成されたキューブ テクスチャ オブジェクトを表す、IDirect3DCubeTexture8 インターフェイスへのポインタのアドレス。

戻り値

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

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

D3DERR_INVALIDCALL
D3DERR_NOTAVAILABLE
D3DERR_OUTOFVIDEOMEMORY
D3DXERR_INVALIDDATA
E_OUTOFMEMORY

注意

#define UNICODE スイッチを挿入または除外して、アプリケーションで Unicode または ANSI 文字列のどちらを使用するかを指定する。次のコードは、D3DXCreateCubeTextureFromFile の定義方法を示している。

#ifdef UNICODE
#define D3DXCreateCubeTextureFromFile D3DXCreateCubeTextureFromFileW
#else
#define D3DXCreateCubeTextureFromFile D3DXCreateCubeTextureFromFileA
#endif

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

D3DXCreateCubeTextureFromFileInMemoryW は、DirectDrawSurface (DDS) ファイル フォーマットを使用する。DXTex ツールによって、ほかのファイル フォーマットからキューブ マップを生成し、それを DDS ファイル フォーマットで保存することができる。

動作環境

  ヘッダー : d3dx8mesh.h で宣言。

参照

D3DXCreateCubeTextureFromFileA