Funzione D3DXCreateVolumeTextureFromFile

Crea una trama del volume da un file.

Sintassi

HRESULT D3DXCreateVolumeTextureFromFile(
  _In_  LPDIRECT3DDEVICE9        pDevice,
  _In_  LPCTSTR                  pSrcFile,
  _Out_ LPDIRECT3DVOLUMETEXTURE9 *ppVolumeTexture
);

Parametri

pDevice [in]

Tipo: LPDIRECT3DDEVICE9

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

pSrcFile [in]

Tipo: LPCTSTR

Puntatore a una stringa che specifica il nome del file. Se le impostazioni del compilatore richiedono Unicode, il tipo di dati LPCTSTR viene risolto in LPCWSTR. In caso contrario, il tipo di dati stringa viene risolto in LPCSTR. Vedere la sezione Osservazioni.

ppVolumeTexture [out]

Tipo: LPDIRECT3DVOLUMETEXTURE9*

Indirizzo di un puntatore a un'interfaccia IDirect3DVolumeTexture9 che rappresenta l'oggetto trama 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_NOTAVAILABLE, D3DERR_OUTOFVIDEOMEMORY, D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA, E_OUTOFMEMORY.

Commenti

L'impostazione del compilatore determina anche la versione della funzione. Se Unicode è definito, la chiamata alla funzione viene risolta in D3DXCreateVolumeTextureFromFileW. In caso contrario, la chiamata alla funzione viene risolta in D3DXCreateVolumeTextureFromFileA perché vengono usate stringhe ANSI.

La funzione equivale a D3DXCreateVolumeTextureFromFileEx(pDevice, pSrcFile, D3DX_DEFAULT, D3DX_DEFAULT, D3DX_DEFAULT, D3DX_DEFAULT, 0, D3DFMT_UNKNOWN, D3DPOOL_MANAGED, D3DX_DEFAULT, D3DX_DEFAULT, 0, NULL, ppVolumeTexture).

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

Le trame mipmapped hanno automaticamente ogni livello riempito con la trama caricata.

Quando si caricano immagini in trame mipmapped, alcuni dispositivi non possono passare a un'immagine 1x1 e questa funzione avrà esito negativo. In questo caso, le immagini devono essere caricate manualmente.

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.

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.

Requisiti

Requisito	Valore
Intestazione	D3dx9tex.h
Libreria	D3dx9.lib

Vedi anche

D3DXCreateVolumeTextureFromFileEx

D3DXCreateVolumeTextureFromFileInMemory

D3DXCreateVolumeTextureFromFileInMemoryEx

D3DXCreateVolumeTextureFromResource

D3DXCreateVolumeTextureFromResourceEx

Funzioni trama in D3DX 9