Funzione D3DXCreateCubeTextureFromFileInMemory

Articolo
06/13/2023

Crea una trama del cubo da un file in memoria.

Sintassi

HRESULT D3DXCreateCubeTextureFromFileInMemory(
  _In_  LPDIRECT3DDEVICE9      pDevice,
  _In_  LPCVOID                pSrcData,
  _In_  UINT                   SrcDataSize,
  _Out_ LPDIRECT3DCUBETEXTURE9 *ppCubeTexture
);

Parametri

pDevice [in]

Tipo: LPDIRECT3DDEVICE9

Puntatore a un'interfaccia IDirect3DDevice9 che rappresenta il dispositivo da associare alla trama del cubo.

pSrcData [in]

Tipo: LPCVOID

Puntatore al file in memoria da cui creare la mappa del cubo. Vedere la sezione Osservazioni.

SrcDataSize [in]

Tipo: UINT

Dimensioni del file in memoria, in byte.

ppCubeTexture [out]

Tipo: LPDIRECT3DCUBETEXTURE9*

Indirizzo di un puntatore a un'interfaccia IDirect3DCubeTexture9 che rappresenta l'oggetto trama del cubo creato.

Valore restituito

Tipo: HRESULT

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

Commenti

Questa funzione supporta i formati di file seguenti: .bmp, .dds, .dib, .hdr, .jpg, .pfm, .png, .ppm e tga. Vedere D3DXIMAGE_FILEFORMAT.

La funzione equivale a D3DXCreateCubeTextureFromFileInMemoryEx(pDevice, pSrcData, SrcDataSize, D3DX_DEFAULT, D3DX_DEFAULT, 0, D3DFMT_UNKNOWN, D3DPOOL_MANAGED, D3DX_DEFAULT, D3DX_DEFAULT, 0, NULL, NULL, ppCubeTexture).

Si noti che una risorsa creata con questa funzione quando viene chiamata da un oggetto IDirect3DDevice9 verrà inserita nella classe di memoria denotata da D3DPOOL_MANAGED. Quando questo metodo viene chiamato da un oggetto IDirect3DDevice9Ex, la risorsa verrà inserita nella classe di memoria denotata da D3DPOOL_DEFAULT.

Questo metodo è progettato per essere usato per caricare i file di immagine archiviati come RT_RCDATA, ovvero una risorsa definita dall'applicazione (dati non elaborati). In caso contrario, questo metodo avrà esito negativo.

Il filtro viene applicato automaticamente a una trama creata usando questo metodo. Il filtro equivale a D3DX_FILTER_TRIANGLE | D3DX_FILTER_DITHER in D3DX_FILTER.

D3DXCreateCubeTextureFromFileInMemory usa il formato di file DDS (DirectDraw surface). L'editor di trame DirectX (Dxtex.exe) consente di generare una mappa del cubo da altri formati di file e salvarla nel formato di file DDS. È possibile ottenere Dxtex.exe e scoprirlo da DirectX SDK. Per informazioni su DirectX SDK, vedere Dove è DirectX SDK?.

Requisiti

Requisito	Valore
Intestazione	D3dx9tex.h
Libreria	D3dx9.lib

Vedi anche

Funzioni trama in D3DX 9

Condividi tramite