Funzione D3DXLoadVolumeFromResource
Carica un volume da una risorsa.
Sintassi
HRESULT D3DXLoadVolumeFromResource(
_In_ LPDIRECT3DVOLUME9 pDestVolume,
_In_ const PALETTEENTRY *pDestPalette,
_In_ const D3DBOX *pDestBox,
_In_ HMODULE hSrcModule,
_In_ LPCSTR pSrcResource,
_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.
-
hSrcModule [in]
-
Tipo: HMODULE
Gestire il modulo in cui si trova la risorsa o NULL per il modulo associato all'immagine usata per creare il processo corrente.
-
pSrcResource [in]
-
Tipo: LPCSTR
Puntatore a una stringa che specifica il nome file dell'immagine di origine. Se unicode o _UNICODE sono definiti, questo tipo di parametro è LPCWSTR, in caso contrario, il tipo è LPCSTR.
-
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
La risorsa caricata deve essere una risorsa bitmap(RT_BITMAP).
Questa funzione gestisce la conversione in e da formati di trama compressi.
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.
Questa funzione supporta stringhe Unicode e ANSI.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione |
|
| Libreria |
|
Vedi anche