D3DXLoadSurfaceFromSurface-Funktion
Lädt eine Oberfläche von einer anderen Oberfläche mit Farbkonvertierung.
Syntax
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
);
Parameter
-
pDestSurface [ In]
-
Typ: LPDIRECT3DSURFACE9
Zeiger auf eine IDirect3DSurface9-Schnittstelle. Gibt die Zieloberfläche an, die das Bild empfängt.
-
pDestPalette [ In]
-
Typ: const PALETTEENTRY *
Zeiger auf eine PALETTEENTRY-Struktur, die Zielpalette mit 256 Farben oder NULL.
-
pDestRect [ In]
-
Typ: const RECT *
Zeiger auf eine RECT-Struktur. Gibt das Zielrechteck an. Legen Sie diesen Parameter auf NULL fest, um die gesamte Oberfläche anzugeben.
-
pSrcSurface [ In]
-
Typ: LPDIRECT3DSURFACE9
Zeiger auf eine IDirect3DSurface9-Schnittstelle, die die Quelloberfläche darstellt.
-
pSrcPalette [ In]
-
Typ: const PALETTEENTRY *
Zeiger auf eine PALETTEENTRY-Struktur, die Quellpalette mit 256 Farben oder NULL.
-
pSrcRect [ In]
-
Typ: const RECT *
Zeiger auf eine RECT-Struktur. Gibt das Quellrechteck an. Legen Sie diesen Parameter auf NULL fest, um die gesamte Oberfläche anzugeben.
-
Filterung [ In]
-
Typ: DWORD
Eine Kombination aus einem oder mehreren _ D3DX-FILTERN,die steuern, wie das Bild gefiltert wird. Die Angabe von D3DX _ DEFAULT für diesen Parameter entspricht der Angabe von D3DX FILTER TRIANGLE _ _ | D3DX _ FILTER _ DITHER.
-
ColorKey [ In]
-
Typ: D3DCOLOR
D3DCOLOR-Wert, der durch transparentes Schwarz ersetzt werden soll, oder 0, um den Farbschlüssel zu deaktivieren. Dies ist immer eine 32-Bit-ARGB-Farbe, unabhängig vom Quellbildformat. Alpha ist von Bedeutung und sollte in der Regel für nicht transparente Farbschlüssel auf FF festgelegt werden. Daher wäre der Wert für nicht transparentes Schwarz gleich 0xFF000000.
Rückgabewert
Typ: HRESULT
Wenn die Funktion erfolgreich ausgeführt wird, lautet der Rückgabewert D3D _ OK. Wenn die Funktion fehlschlägt, kann der Rückgabewert einer der folgenden Werte sein: D3DERR _ INVALIDCALL, D3DXERR _ INVALIDDATA.
Hinweise
Diese Funktion verarbeitet die Konvertierung in und aus komprimierten Texturformaten.
Das Schreiben in eine Oberfläche ungleich null führt nicht dazu, dass das geänderte Rechteck aktualisiert wird. Wenn D3DXLoadSurfaceFromSurface aufgerufen wird und die Oberfläche noch nicht geändert wurde (dies ist in normalen Verwendungsszenarien unwahrscheinlich), muss die Anwendung AddDirtyRect explizit auf der Oberfläche aufrufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header |
|
| Bibliothek |
|