Microsoft DirectX 8.0 (C++)

D3DXCreateCubeTextureFromFileW

Creates a cube texture from a file specified by a Unicode string.

D3DXCreateCubeTextureFromFile maps to either D3DXCreateCubeTextureFromFileA or D3DXCreateCubeTextureFromFileW, depending on the inclusion or exclusion of the #define UNICODE switch, see Remarks.

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

Parameters

pDevice
[in] Pointer to an IDirect3DDevice8 interface, representing the device to be associated with the cube texture.
pSrcFile
[in] Pointer to a Unicode string that specifies the file from which to create the cube texture. See Remarks.
ppCubeTexture
[out] Address of a pointer to an IDirect3DCubeTexture8 interface, representing the created cube texture object.

Return Values

If the function succeeds, the return value is D3D_OK.

If the function fails, the return value can be one of the following values.

D3DERR_INVALIDCALL
D3DERR_NOTAVAILABLE
D3DERR_OUTOFVIDEOMEMORY
D3DXERR_INVALIDDATA
E_OUTOFMEMORY

Remarks

Include or exclude the #define UNICODE switch to specify whether your application expects Unicode or ANSI strings. The following code fragment shows how D3DXCreateCubeTextureFromFile is defined.

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

Note that a resource created with this function will be placed in the memory class denoted by D3DPOOL_MANAGED.

D3DXCreateCubeTextureFromFileInMemoryW uses the DirectDrawSurface (DDS) file format. The DXTex Tool enables you to generate a cube map from other file formats and save it in the DDS file format.

Requirements

  Header: Declared in D3dx8tex.h.

See Also

D3DXCreateCubeTextureFromFileA