Funzione D3DXLoadVolumeFromMemory

Articolo
06/13/2023

Carica un volume dalla memoria.

Sintassi

HRESULT D3DXLoadVolumeFromMemory(
  _In_       LPDIRECT3DVOLUME9 pDestVolume,
  _In_ const PALETTEENTRY      *pDestPalette,
  _In_ const D3DBOX            *pDestBox,
  _In_       LPCVOID           pSrcMemory,
  _In_       D3DFORMAT         SrcFormat,
  _In_       UINT              SrcRowPitch,
  _In_       UINT              SrcSlicePitch,
  _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.

pSrcMemory [in]

Tipo: LPCVOID

Puntatore all'angolo superiore sinistro del volume di origine in memoria.

SrcFormat [in]

Tipo: D3DFORMAT

Membro del tipo enumerato D3DFORMAT , il formato pixel del volume di origine.

SrcRowPitch [in]

Tipo: UINT

Inclinazione dell'immagine di origine, in byte. Per i formati DXT (formati di trama compressi), questo numero deve rappresentare le dimensioni di una riga di celle, in byte.

SrcSlicePitch [in]

Tipo: UINT

Inclinazione dell'immagine di origine, in byte. Per i formati DXT (formati di trama compressi), questo numero deve rappresentare le dimensioni di una sezione di celle, in byte.

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. NULL non è un valore valido per questo parametro.

Filtro [in]

Tipo: DWORD

Combinazione di uno 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.

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 valori 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 D3DXLoadVolumeFromMemory 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	D3dx9tex.h
Libreria	D3dx9.lib

Vedi anche

D3DXLoadVolumeFromFile
D3DXLoadVolumeFromResource
D3DXLoadVolumeFromVolume
Funzioni trama in D3DX 9

Condividi tramite