Método IDirect3DDevice9::CreateCubeTexture (d3d9.h)

Artigo
08/23/2023

Cria um recurso de textura de cubo.

Sintaxe

HRESULT CreateCubeTexture(
  [in]          UINT                  EdgeLength,
  [in]          UINT                  Levels,
  [in]          DWORD                 Usage,
  [in]          D3DFORMAT             Format,
  [in]          D3DPOOL               Pool,
  [out, retval] IDirect3DCubeTexture9 **ppCubeTexture,
  [in]          HANDLE                *pSharedHandle
);

Parâmetros

[in] EdgeLength

Tipo: UINT

Tamanho das bordas de todas as faces de nível superior da textura do cubo. As dimensões de pixel dos níveis subsequentes de cada face serão o valor truncado de metade da dimensão de pixel do nível anterior (independentemente). Cada dimensão é fixada em um tamanho de 1 pixel. Assim, se a divisão por 2 resultar em 0 (zero), 1 será tomada em vez disso.

[in] Levels

Tipo: UINT

Número de níveis em cada face da textura do cubo. Se isso for zero, o Direct3D gerará todos os subnível de textura de cubo até 1x1 pixels para cada face para hardware que dá suporte a texturas de cubo mipmapped. Chame IDirect3DBaseTexture9::GetLevelCount para ver o número de níveis gerados.

[in] Usage

Tipo: DWORD

O uso pode ser 0, o que indica nenhum valor de uso. No entanto, se o uso for desejado, use uma combinação de uma ou mais constantes D3DUSAGE . É uma boa prática corresponder o parâmetro de uso em CreateCubeTexture com os sinalizadores de comportamento em IDirect3D9::CreateDevice. Para obter mais informações, consulte Comentários.

[in] Format

Tipo: D3DFORMAT

Membro do tipo enumerado D3DFORMAT , descrevendo o formato de todos os níveis em todas as faces da textura do cubo.

[in] Pool

Tipo: D3DPOOL

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

[out, retval] ppCubeTexture

Tipo: IDirect3DCubeTexture9**

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

[in] pSharedHandle

Tipo: HANDLE*

Reservado. Defina esse parâmetro como NULL. Esse parâmetro pode ser usado no Direct3D 9 para o Windows Vista compartilhar recursos.

Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, o valor retornado será D3D_OK. Se o método falhar, o valor retornado poderá ser um dos seguintes: D3DERR_INVALIDCALL, D3DERR_OUTOFVIDEOMEMORY E_OUTOFMEMORY.

Comentários

Um mipmap (textura) é uma coleção de superfícies sucessivamente downsampled (mipmapped). Por outro lado, uma textura de cubo (criada por IDirect3DDevice9::CreateCubeTexture) é uma coleção de seis texturas (mipmaps), uma para cada rosto. Todas as faces devem estar presentes na textura do cubo. Além disso, uma superfície de mapa de cubo deve ter o mesmo tamanho de pixel em todas as três dimensões (x, y e z).

Um aplicativo pode descobrir o suporte para a Geração Automática de Mipmaps (Direct3D 9) em um formato específico chamando IDirect3D9::CheckDeviceFormat com D3DUSAGE_AUTOGENMIPMAP. Se IDirect3D9::CheckDeviceFormat retornar D3DOK_NOAUTOGEN, IDirect3DDevice9::CreateCubeTexture terá êxito , mas retornará uma textura de um nível.