Funzione D3DXLoadSurfaceFromSurface

Articolo
06/13/2023

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

Vedi anche

Funzioni trama in D3DX 9

Condividi tramite