Metodo IDirect3DDevice9::CreateCubeTexture (d3d9.h)

Articolo
08/23/2023

Crea una risorsa trama del cubo.

Sintassi

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

Parametri

[in] EdgeLength

Tipo: UINT

Dimensioni dei bordi di tutti i visi di primo livello della trama del cubo. Le dimensioni dei pixel dei livelli successivi di ogni viso saranno il valore troncato della metà della dimensione pixel del livello precedente (in modo indipendente). Ogni dimensione si blocca a una dimensione di 1 pixel. Pertanto, se la divisione per 2 risultati in 0 (zero), 1 verrà invece presa.

[in] Levels

Tipo: UINT

Numero di livelli in ogni faccia della trama del cubo. Se si tratta di zero, Direct3D genererà tutte le trame del cubo sublevel fino a 1x1 pixel per ogni viso per l'hardware che supporta trame del cubo mipmapped. Chiamare IDirect3DBaseTexture9::GetLevelCount per visualizzare il numero di livelli generati.

[in] Usage

Tipo: DWORD

L'utilizzo può essere 0, che indica nessun valore di utilizzo. Tuttavia, se si desidera usare una combinazione di una o più costanti D3DUSAGE . È consigliabile corrispondere al parametro di utilizzo in CreateCubeTexture con i flag di comportamento in IDirect3D9::CreateDevice. Per altre informazioni, vedere la sezione Osservazioni.

[in] Format

Tipo: D3DFORMAT

Membro del tipo enumerato D3DFORMAT , che descrive il formato di tutti i livelli in tutti i volti della trama del cubo.

[in] Pool

Tipo: D3DPOOL

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

[out, retval] ppCubeTexture

Tipo: IDirect3DCubeTexture9**

Indirizzo di un puntatore a un'interfaccia IDirect3DCubeTexture9 che rappresenta la risorsa trama del cubo creata.

[in] pSharedHandle

Tipo: HANDLE*

Riservato. Impostare questo parametro su NULL. Questo parametro può essere usato in Direct3D 9 per Windows Vista per condividere le risorse.

Valore restituito

Tipo: HRESULT

Se il metodo ha esito positivo, il valore restituito è D3D_OK. Se il metodo ha esito negativo, il valore restituito può essere uno dei seguenti: D3DERR_INVALIDCALL, D3DERR_OUTOFVIDEOMEMORY, E_OUTOFMEMORY.

Commenti

Una mappa mipmap (trama) è una raccolta di superfici successivamente downampled (mipmapped). D'altra parte, una trama del cubo (creata da IDirect3DDevice9::CreateCubeTexture) è una raccolta di sei trame (mipmap), una per ogni viso. Tutti i visi devono essere presenti nella trama del cubo. Inoltre, una superficie mappa cubo deve essere la stessa dimensione pixel in tutte e tre le dimensioni (x, y e z).

Un'applicazione può individuare il supporto per la generazione automatica di Mipmaps (Direct3D 9) in un formato specifico chiamando IDirect3D9::CheckDeviceFormat con D3DUSAGE_AUTOGENMIPMAP. Se IDirect3D9::CheckDeviceFormat restituisce D3DOK_NOAUTOGEN, IDirect3DDevice9::CreateCubeTexture avrà esito positivo, ma restituirà una trama a un livello.