Microsoft DirectX 8.1 (C++)

D3DXCreateCubeTextureFromResource

Creates a cube texture from a resource.

HRESULT D3DXCreateCubeTextureFromResource(
  LPDIRECT3DDEVICE8       pDevice,
  HMODULE                 hSrcModule,  
  LPCTSTR                  pSrcResource,
  LPDIRECT3DCUBETEXTURE8* ppCubeTexture
);

Parameters

pDevice
[in] Pointer to an IDirect3DDevice8 interface, representing the device to be associated with the cube texture.
pSrcResource
[in] Pointer to a string that specifies the resource from which to create the cube texture.
hSrcModule
[in] Handle to the module where the resource is located, or NULL for the module associated with the image the operating system used to create the current process.
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

This function supports the following resource formats: .bmp, .dds, .dib, .jpg, .png, and .tga.

This function supports both Unicode and ANSI strings.

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

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

Requirements

  Header: Declared in D3dx8tex.h.

See Also

D3DXCreateCubeTextureFromResourceEx