Funzione D3DXLoadVolumeFromFile
Carica un volume da un file.
Sintassi
HRESULT D3DXLoadVolumeFromFile(
_In_ LPDIRECT3DVOLUME9 pDestVolume,
_In_ const PALETTEENTRY *pDestPalette,
_In_ const D3DBOX *pDestBox,
_In_ LPCTSTR pSrcFile,
_In_ const D3DBOX *pSrcBox,
_In_ DWORD Filter,
_In_ D3DCOLOR ColorKey,
_In_ D3DXIMAGE_INFO *pSrcInfo
);
Parametri
-
pDestVolume [in]
-
Tipo: LPDIRECT3DVOLUME9
Puntatore a un'interfaccia IDirect3DVolume9 . Specifica il volume di destinazione.
-
pDestPalette [in]
-
Tipo: const PALETTEENTRY*
Puntatore a una struttura PALETTEENTRY , la tavolozza di destinazione di 256 colori o NULL.
-
pDestBox [in]
-
Tipo: const D3DBOX*
Puntatore a una struttura D3DBOX . Specifica la casella di destinazione. Impostare questo parametro su NULL per specificare l'intero volume.
-
pSrcFile [in]
-
Tipo: LPCTSTR
Puntatore a una stringa che specifica il nome 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.
-
pSrcBox [in]
-
Tipo: const D3DBOX*
Puntatore a una struttura D3DBOX . Specifica la casella di origine. Impostare questo parametro su NULL per specificare l'intero volume.
-
Filtro [in]
-
Tipo: DWORD
Combinazione di una o più D3DX_FILTER, controllando il modo in cui l'immagine viene filtrata. Se si specifica D3DX_DEFAULT per questo parametro, è l'equivalente di specificare D3DX_FILTER_TRIANGLE | D3DX_FILTER_DITHER.
-
ColorKey [in]
-
Tipo: D3DCOLOR
Valore D3DCOLOR da sostituire con nero trasparente o 0 per disabilitare la chiave di colore. Si tratta sempre di un colore ARGB a 32 bit, indipendentemente dal formato dell'immagine di origine. Alfa è significativo e in genere deve essere impostato su FF per chiavi di colore opache. Pertanto, per il nero opaco, il valore sarebbe uguale a 0xFF000000.
-
pSrcInfo [in]
-
Tipo: D3DXIMAGE_INFO*
Puntatore a una struttura D3DXIMAGE_INFO da compilare con una descrizione dei dati nel file di immagine di origine o NULL.
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 valori seguenti: D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA.
Commenti
L'impostazione del compilatore determina anche la versione della funzione. Se Unicode è definito, la chiamata alla funzione viene risolta in D3DXLoadVolumeFromFileW. In caso contrario, la chiamata alla funzione viene risolta in D3DXLoadVolumeFromFileA perché vengono usate stringhe ANSI.
Questa funzione gestisce la conversione in e dai formati di trama compressi e supporta i formati di file seguenti: .bmp, .dds, .dib, .hdr, .jpg, pfm, .png, .ppm e tga. Vedere D3DXIMAGE_FILEFORMAT.
La scrittura in una superficie non di livello zero della trama del volume non causerà l'aggiornamento del rettangolo sporco. Se D3DXLoadVolumeFromFile viene chiamato e la trama non era già sporca (questo è improbabile in scenari di utilizzo normali), l'applicazione deve chiamare in modo esplicito IDirect3DVolumeTexture9::AddDirtyBox nella trama del volume.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione |
|
| Libreria |
|
Vedi anche