Função D3DXCreateTexture

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

Sintaxe

HRESULT D3DXCreateTexture(
  _In_  LPDIRECT3DDEVICE9  pDevice,
  _In_  UINT               Width,
  _In_  UINT               Height,
  _In_  UINT               MipLevels,
  _In_  DWORD              Usage,
  _In_  D3DFORMAT          Format,
  _In_  D3DPOOL            Pool,
  _Out_ LPDIRECT3DTEXTURE9 *ppTexture
);

Parâmetros

pDevice [in]

Tipo: LPDIRECT3DDEVICE9

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

Largura [in]

Tipo: UINT

Largura em pixels. Se esse valor for 0, um valor de 1 será usado. Consulte Observações.

Altura [in]

Tipo: UINT

Altura em pixels. Se esse valor for 0, um valor de 1 será usado. Consulte Observações.

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 chamando o método SetRenderTarget . Se D3DUSAGE_RENDERTARGET ou D3DUSAGE_DYNAMIC 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. A textura retornada pode ser de um formato diferente daquele especificado, se o dispositivo não der suporte ao formato solicitado. Os aplicativos devem marcar o formato da textura retornada para ver se corresponde ao formato solicitado.

Pool [in]

Tipo: D3DPOOL

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

ppTexture [out]

Tipo: LPDIRECT3DTEXTURE9*

Endereço de um ponteiro para uma interface IDirect3DTexture9 , representando o objeto de textura 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

Internamente, D3DXCreateTexture usa D3DXCheckTextureRequirements para ajustar os parâmetros de chamada. Portanto, as chamadas para D3DXCreateTexture geralmente terão êxito quando as chamadas para CreateTexture falharem.

Se Height e Width forem definidos como D3DX_DEFAULT, um valor de 256 será usado para ambos os parâmetros. Se Height ou Width estiver definido como D3DX_DEFAULT E o outro parâmetro for definido como um valor numérico, a textura será quadrada com a altura e a largura iguais ao valor numérico.

Requisitos

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

Confira também

Funções de textura no D3DX 9