Funzione D3DXLoadSurfaceFromFile
Carica una superficie da un file.
Sintassi
HRESULT D3DXLoadSurfaceFromFile(
_In_ LPDIRECT3DSURFACE9 pDestSurface,
_In_ const PALETTEENTRY *pDestPalette,
_In_ const RECT *pDestRect,
_In_ LPCTSTR pSrcFile,
_In_ const RECT *pSrcRect,
_In_ DWORD Filter,
_In_ D3DCOLOR ColorKey,
_Inout_ D3DXIMAGE_INFO *pSrcInfo
);
Parametri
-
pDestSurface [in]
-
Tipo: LPDIRECT3DSURFACE9
Puntatore a un'interfaccia IDirect3DSurface9 . Specifica la superficie 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.
-
pDestRect [in]
-
Tipo: const RECT*
Puntatore a una struttura RECT . Specifica il rettangolo di destinazione. Impostare questo parametro su NULL per specificare l'intera superficie.
-
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.
-
pSrcRect [in]
-
Tipo: const RECT*
Puntatore a una struttura RECT . Specifica il rettangolo di origine. Impostare questo parametro su NULL per specificare l'intera immagine.
-
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.
-
pSrcInfo [in, out]
-
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 valori seguenti: D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA.
Commenti
L'impostazione del compilatore determina anche la versione della funzione. Se è definito Unicode, la chiamata di funzione viene risolta in D3DXLoadSurfaceFromFileW. In caso contrario, la chiamata di funzione viene risolta in D3DXLoadSurfaceFromFileA perché vengono usate stringhe ANSI.
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 non causerà l'aggiornamento del rettangolo dirty. Se viene chiamato D3DXLoadSurfaceFromFile e la superficie non era già dirty (probabilmente in scenari di utilizzo normali), l'applicazione deve chiamare in modo esplicito AddDirtyRect sulla superficie.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione |
|
| Libreria |
|
Vedi anche