Função D3DXCreateCubeTextureFromResource

Cria uma textura de cubo com base em um recurso.

Sintaxe

HRESULT D3DXCreateCubeTextureFromResource(
  _In_  LPDIRECT3DDEVICE9      pDevice,
  _In_  HMODULE                hSrcModule,
  _In_  LPCTSTR                pSrcResource,
  _Out_ LPDIRECT3DCUBETEXTURE9 *ppCubeTexture
);

Parâmetros

pDevice [in]

Tipo: LPDIRECT3DDEVICE9

Ponteiro para uma interface IDirect3DDevice9 , representando o dispositivo a ser associado à textura do cubo.

hSrcModule [in]

Tipo: HMODULE

Manipule para o módulo em que o recurso está localizado ou NULL para o módulo associado à imagem que o sistema operacional usou para criar o processo atual.

pSrcResource [in]

Tipo: LPCTSTR

Ponteiro para uma cadeia de caracteres que especifica o nome do recurso. Se as configurações do compilador exigirem Unicode, o tipo de dados LPCTSTR será resolvido para LPCWSTR. Caso contrário, o tipo de dados de cadeia de caracteres será resolvido para LPCSTR. Consulte Observações.

ppCubeTexture [out]

Tipo: LPDIRECT3DCUBETEXTURE9*

Endereço de um ponteiro para uma interface IDirect3DCubeTexture9 , representando o objeto de textura de cubo criado.

Valor retornado

Tipo: HRESULT

Se a função for bem-sucedida, o valor retornado será D3D_OK. Se a função falhar, o valor retornado poderá ser um dos seguintes valores: D3DERR_INVALIDCALL, D3DERR_NOTAVAILABLE, D3DERR_OUTOFVIDEOMEMORY, D3DXERR_INVALIDDATA E_OUTOFMEMORY.

Comentários

A configuração do compilador determina a versão da função. Se Unicode for definido, a chamada de função será resolvida para D3DXCreateCubeTextureFromResourceW. Caso contrário, a chamada de função será resolvida para D3DXCreateCubeTextureFromResourceA porque as cadeias de caracteres ANSI estão sendo usadas.

A função é equivalente a D3DXCreateCubeTextureFromResourceEx(pDevice, hSrcModule, pSrcResource, D3DX_DEFAULT, D3DX_DEFAULT, 0, D3DFMT_UNKNOWN, D3DPOOL_MANAGED, D3DX_DEFAULT, D3DX_DEFAULT, 0, NULL, NULL, ppCubeTexture).

Essa função dá suporte aos seguintes formatos de arquivo: .bmp, .dds, .dib, .hdr, .jpg, .pfm, .png, .ppm e .tga. Confira D3DXIMAGE_FILEFORMAT.

Observe que um recurso criado com essa função quando chamado de um objeto IDirect3DDevice9 será colocado na classe de memória indicada por D3DPOOL_MANAGED. Quando esse método é chamado de um objeto IDirect3DDevice9Ex, o recurso será colocado na classe de memória indicada por D3DPOOL_DEFAULT.

A filtragem é aplicada automaticamente a uma textura criada usando esse método. A filtragem é equivalente a D3DX_FILTER_TRIANGLE | D3DX_FILTER_DITHER em D3DX_FILTER.

D3DXCreateCubeTextureFromResource usa o formato de arquivo DDS (superfície DirectDraw). O Editor de Textura DirectX (Dxtex.exe) permite gerar um mapa de cubo de outros formatos de arquivo e salvá-lo no formato de arquivo DDS. Você pode obter Dxtex.exe e saber mais sobre isso no SDK do DirectX. Para obter informações sobre o SDK do DirectX, consulte Onde está o SDK do DirectX?.

Requisitos

Requisito	Valor
parâmetro	D3dx9tex.h
Biblioteca	D3dx9.lib

Confira também

D3DXCreateCubeTextureFromResourceEx

Funções de textura no D3DX 9