Funzione D3DXCreateCubeTexture

Articolo
06/13/2023

Crea una trama di cubo vuota, regolando i parametri chiamanti in base alle esigenze.

Sintassi

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

Parametri

pDevice [in]

Tipo: LPDIRECT3DDEVICE9

Puntatore a un'interfaccia IDirect3DDevice9 che rappresenta il dispositivo da associare alla trama.

Dimensioni [in]

Tipo: UINT

Larghezza e altezza della trama del cubo, in pixel. Ad esempio, se la trama del cubo è un cubo di 8 pixel per 8 pixel, il valore di questo parametro deve essere 8.

MipLevels [in]

Tipo: UINT

Numero di livelli mip richiesti. Se questo valore è zero o D3DX_DEFAULT, viene creata una catena mipmap completa.

Utilizzo [in]

Tipo: DWORD

0, D3DUSAGE_RENDERTARGET o D3DUSAGE_DYNAMIC. L'impostazione di questo flag su D3DUSAGE_RENDERTARGET indica che la superficie deve essere usata come destinazione di rendering. La risorsa può quindi essere passata al parametro pNewRenderTarget del metodo SetRenderTarget . Se viene specificato D3DUSAGE_RENDERTARGET, l'applicazione deve verificare che il dispositivo supporti questa operazione chiamando CheckDeviceFormat. Per altre informazioni sull'uso di trame dinamiche, vedere Uso di trame dinamiche.

Formato [in]

Tipo: D3DFORMAT

Membro del tipo enumerato D3DFORMAT , che descrive il formato pixel richiesto per la trama del cubo. La trama del cubo restituita potrebbe avere un formato diverso da quello specificato da Format. Le applicazioni devono controllare il formato della trama del cubo restituita.

Pool [in]

Tipo: D3DPOOL

Membro del tipo enumerato D3DPOOL , che descrive la classe di memoria in cui deve essere inserita la trama del cubo.

ppCubeTexture [out]

Tipo: LPDIRECT3DCUBETEXTURE9*

Indirizzo di un puntatore a un'interfaccia IDirect3DCubeTexture9 che rappresenta l'oggetto trama del cubo creato.

Valore restituito

Tipo: HRESULT

Se la funzione ha esito positivo, il valore restituito viene D3D_OK. Se la funzione ha esito negativo, il valore restituito può essere uno dei seguenti: D3DERR_INVALIDCALL, D3DERR_NOTAVAILABLE, D3DERR_OUTOFVIDEOMEMORY E_OUTOFMEMORY.

Commenti

Le trame del cubo differiscono dalle altre superfici in quanto sono raccolte di superfici.

Internamente, D3DXCreateCubeTexture usa D3DXCheckCubeTextureRequirements per regolare i parametri chiamanti. Di conseguenza, le chiamate a D3DXCreateCubeTexture avranno spesso esito positivo in caso di errore delle chiamate a CreateCubeTexture .

Requisiti

Requisito	Valore
Intestazione	D3dx9tex.h
Libreria	D3dx9.lib

Vedi anche

Funzioni trama in D3DX 9