Funzione D3DXLoadVolumeFromFileInMemory
Carica un volume da un file in memoria.
Sintassi
HRESULT D3DXLoadVolumeFromFileInMemory(
_In_ LPDIRECT3DVOLUME9 pDestVolume,
_In_ const PALETTEENTRY *pDestPalette,
_In_ const D3DBOX *pDestBox,
_In_ LPCVOID pSrcData,
_In_ UINT SrcDataSize,
_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.
-
pSrcData [in]
-
Tipo: LPCVOID
Puntatore al file in memoria da cui caricare il volume.
-
SrcDataSize [in]
-
Tipo: UINT
Dimensioni in byte del file in memoria.
-
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, controllo della modalità di filtro dell'immagine. Specificare D3DX_DEFAULT per questo parametro equivale a 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 le 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 viene D3D_OK. Se la funzione ha esito negativo, il valore restituito può essere uno dei seguenti: D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA.
Commenti
Questa funzione gestisce la conversione da e verso 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 dirty. Se viene chiamato D3DXLoadVolumeFromFileInMemory e la trama non era già dirty (probabilmente 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