Funzione D3DXLoadVolumeFromVolume

Carica un volume da un altro volume.

Sintassi

HRESULT D3DXLoadVolumeFromVolume(
  _In_       LPDIRECT3DVOLUME9 pDestVolume,
  _In_ const PALETTEENTRY      *pDestPalette,
  _In_ const D3DBOX            *pDestBox,
  _In_       LPDIRECT3DVOLUME9 pSrcVolume,
  _In_ const PALETTEENTRY      *pSrcPalette,
  _In_ const D3DBOX            *pSrcBox,
  _In_       DWORD             Filter,
  _In_       D3DCOLOR          ColorKey
);

Parametri

pDestVolume [in]

Tipo: LPDIRECT3DVOLUME9

Puntatore a un'interfaccia IDirect3DVolume9 . Specifica il volume di destinazione che riceve l'immagine.

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.

pSrcVolume [in]

Tipo: LPDIRECT3DVOLUME9

Puntatore a un'interfaccia IDirect3DVolume9 . Specifica il volume di origine.

pSrcPalette [in]

Tipo: const PALETTEENTRY*

Puntatore a una struttura PALETTEENTRY , la tavolozza di origine di 256 colori o NULL.

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, che controlla la 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.

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

La scrittura in una superficie non di livello zero della trama del volume non causerà l'aggiornamento del rettangolo dirty. Se viene chiamato D3DXLoadVolumeFromVolume e la superficie non era già dirty (probabilmente in scenari di utilizzo normali), l'applicazione deve chiamare in modo esplicito IDirect3DVolumeTexture9::AddDirtyBox sulla superficie.

Requisiti

Requisito	Valore
Intestazione	D3dx9tex.h
Libreria	D3dx9.lib

Vedi anche

D3DXLoadVolumeFromFile

D3DXLoadVolumeFromFileInMemory

D3DXLoadVolumeFromMemory

D3DXLoadVolumeFromResource

Funzioni trama in D3DX 9