Função D3DXCreateCubeTexture

Cria uma textura de cubo vazia, ajustando os parâmetros de chamada conforme necessário.

Sintaxe

HRESULT D3DXCreateCubeTexture(
  _In_  LPDIRECT3DDEVICE9      pDevice,
  _In_  UINT                   Size,
  _In_  UINT                   MipLevels,
  _In_  DWORD                  Usage,
  _In_  D3DFORMAT              Format,
  _In_  D3DPOOL                Pool,
  _Out_ LPDIRECT3DCUBETEXTURE9 *ppCubeTexture
);

Parâmetros

pDevice [in]

Tipo: LPDIRECT3DDEVICE9

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

Tamanho [in]

Tipo: UINT

Largura e altura da textura do cubo, em pixels. Por exemplo, se a textura do cubo for um cubo de 8 pixels por 8 pixels, o valor desse parâmetro deverá ser 8.

MipLevels [in]

Tipo: UINT

Número de níveis de mip solicitados. Se esse valor for zero ou D3DX_DEFAULT, uma cadeia de mipmap completa será criada.

Uso [in]

Tipo: DWORD

0, D3DUSAGE_RENDERTARGET ou D3DUSAGE_DYNAMIC. Definir esse sinalizador como D3DUSAGE_RENDERTARGET indica que a superfície deve ser usada como um destino de renderização. Em seguida, o recurso pode ser passado para o parâmetro pNewRenderTarget do método SetRenderTarget . Se D3DUSAGE_RENDERTARGET for especificado, o aplicativo deverá marcar que o dispositivo dê suporte a essa operação chamando CheckDeviceFormat. Para obter mais informações sobre como usar texturas dinâmicas, consulte Usando texturas dinâmicas.

Formatar [in]

Tipo: D3DFORMAT

Membro do tipo enumerado D3DFORMAT , descrevendo o formato de pixel solicitado para a textura do cubo. A textura de cubo retornada pode ter um formato diferente daquele especificado por Format. Os aplicativos devem marcar o formato da textura de cubo retornada.

Pool [in]

Tipo: D3DPOOL

Membro do tipo enumerado D3DPOOL , descrevendo a classe de memória na qual a textura do cubo deve ser colocada.

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: D3DERR_INVALIDCALL, D3DERR_NOTAVAILABLE, D3DERR_OUTOFVIDEOMEMORY E_OUTOFMEMORY.

Comentários

As texturas de cubo diferem de outras superfícies, pois são coleções de superfícies.

Internamente, D3DXCreateCubeTexture usa D3DXCheckCubeTextureRequirements para ajustar os parâmetros de chamada. Portanto, as chamadas para D3DXCreateCubeTexture geralmente terão êxito quando as chamadas para CreateCubeTexture falharem.

Requisitos

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

Confira também

Funções de textura no D3DX 9