Metodo IDirect3DDevice9::CreateCubeTexture (d3d9.h)
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.
Requisiti
Piattaforma di destinazione | Windows |
Intestazione | d3d9.h (includere D3D9.h) |
Libreria | D3D9.lib |
Vedi anche
D3DXCreateCubeTextureFromFileEx
D3DXCreateCubeTextureFromFileInMemory
D3DXCreateCubeTextureFromFileInMemoryEx
D3DXCreateCubeTextureFromResource