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