Funzione D3DXLoadVolumeFromFile

Articolo
06/13/2023

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

Vedi anche

D3DXLoadVolumeFromFileInMemory
D3DXLoadVolumeFromMemory
D3DXLoadVolumeFromResource
D3DXLoadVolumeFromVolume
Funzioni trama in D3DX 9

Condividi tramite