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 |
|
| Biblioteca |
|
Confira também