Metodo IDirect3DDevice9::CreateCubeTexture (d3d9helper.h)

Articolo
08/23/2023

Crea una risorsa trama 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 in 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 di 2 restituisce 0 (zero), verrà invece preso 1.

[in] Levels

Tipo: UINT

Numero di livelli in ogni viso della trama del cubo. Se questo è zero, Direct3D genererà tutti i sublevel della trama del cubo fino a 1x1 pixel per ogni viso per l'hardware che supporta trame di cubi 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 , usare una combinazione di una o più costanti D3DUSAGE . È consigliabile associare il parametro di utilizzo in CreateCubeTexture ai 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 visi della trama del cubo.

[in] Pool

Tipo: D3DPOOL

Membro del tipo enumerato D3DPOOL , che descrive la classe di memoria in cui deve essere inserita 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 viene D3D_OK. Se il metodo ha esito negativo, il valore restituito può essere uno dei seguenti: D3DERR_INVALIDCALL, D3DERR_OUTOFVIDEOMEMORY E_OUTOFMEMORY.

Commenti

Un mipmap (trama) è una raccolta di superfici di cui è stato successivamente applicato il downcampionamento (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 della mappa cubo deve essere la stessa dimensione in pixel in tutte e tre le dimensioni (x, y e z).

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