Funzione D3DXLoadSurfaceFromSurface
Carica una superficie da un'altra superficie con conversione del colore.
Sintassi
HRESULT D3DXLoadSurfaceFromSurface(
_In_ LPDIRECT3DSURFACE9 pDestSurface,
_In_ const PALETTEENTRY *pDestPalette,
_In_ const RECT *pDestRect,
_In_ LPDIRECT3DSURFACE9 pSrcSurface,
_In_ const PALETTEENTRY *pSrcPalette,
_In_ const RECT *pSrcRect,
_In_ DWORD Filter,
_In_ D3DCOLOR ColorKey
);
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.
-
pSrcSurface [in]
-
Tipo: LPDIRECT3DSURFACE9
Puntatore a un'interfaccia IDirect3DSurface9 che rappresenta la superficie di origine.
-
pSrcPalette [in]
-
Tipo: const PALETTEENTRY*
Puntatore a una struttura PALETTEENTRY , la tavolozza di origine di 256 colori o NULL.
-
pSrcRect [in]
-
Tipo: const RECT*
Puntatore a una struttura RECT . Specifica il rettangolo di origine. Impostare questo parametro su NULL per specificare l'intera superficie.
-
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.
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 seguenti: D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA.
Commenti
Questa funzione gestisce la conversione in e da formati di trama compressi.
La scrittura in una superficie non di livello zero non causerà l'aggiornamento del rettangolo sporco. Se D3DXLoadSurfaceFromSurface viene chiamato e la superficie non era già sporca (questo è improbabile in scenari di utilizzo normali), l'applicazione deve chiamare in modo esplicito AddDirtyRect sulla superficie.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione |
|
| Libreria |
|
Vedi anche