Funzione D3DXCreateTexture
Crea una trama vuota, regolando i parametri chiamanti in base alle esigenze.
Sintassi
HRESULT D3DXCreateTexture(
_In_ LPDIRECT3DDEVICE9 pDevice,
_In_ UINT Width,
_In_ UINT Height,
_In_ UINT MipLevels,
_In_ DWORD Usage,
_In_ D3DFORMAT Format,
_In_ D3DPOOL Pool,
_Out_ LPDIRECT3DTEXTURE9 *ppTexture
);
Parametri
-
pDevice [in]
-
Tipo: LPDIRECT3DDEVICE9
Puntatore a un'interfaccia IDirect3DDevice9 che rappresenta il dispositivo da associare alla trama.
-
Larghezza [in]
-
Tipo: UINT
Larghezza in pixel. Se questo valore è 0, viene utilizzato un valore pari a 1. Vedere la sezione Osservazioni.
-
Altezza [in]
-
Tipo: UINT
Altezza in pixel. Se questo valore è 0, viene utilizzato un valore pari a 1. Vedere la sezione Osservazioni.
-
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 chiamando il metodo SetRenderTarget . Se viene specificato D3DUSAGE_RENDERTARGET o D3DUSAGE_DYNAMIC , 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. La trama restituita può essere di un formato diverso da quello specificato, se il dispositivo non supporta il formato richiesto. Le applicazioni devono controllare il formato della trama restituita per verificare se corrisponde al formato richiesto.
-
Pool [in]
-
Tipo: D3DPOOL
Membro del tipo enumerato D3DPOOL , che descrive la classe di memoria in cui deve essere posizionata la trama.
-
ppTexture [out]
-
Tipo: LPDIRECT3DTEXTURE9*
Indirizzo di un puntatore a un'interfaccia IDirect3DTexture9 che rappresenta l'oggetto trama 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
Internamente, D3DXCreateTexture usa D3DXCheckTextureRequirements per modificare i parametri chiamanti. Di conseguenza, le chiamate a D3DXCreateTexture avranno spesso esito positivo in cui le chiamate a CreateTexture avranno esito negativo.
Se la proprietà Height e Width sono impostate su D3DX_DEFAULT, per entrambi i parametri viene usato un valore pari a 256. Se Height o Width è impostato su D3DX_DEFAULT E l'altro parametro è impostato su un valore numerico, la trama sarà quadrata con l'altezza e la larghezza uguali al valore numerico.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione |
|
| Libreria |
|
Vedi anche