D3DXLoadSurfaceFromFile-Funktion

Lädt eine Oberfläche aus einer Datei.

Syntax

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
);

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.

pSrcFile [ In]

Typ: LPCTSTR

Zeiger auf eine Zeichenfolge, die den Dateinamen angibt. Wenn die Compilereinstellungen Unicode erfordern, wird der Datentyp LPCTSTR in LPCWSTR aufgelöst. Andernfalls wird der Zeichenfolgendatentyp in LPCSTR aufgelöst. Siehe Hinweise.

pSrcRect [ In]

Typ: const RECT *

Zeiger auf eine RECT-Struktur. Gibt das Quellrechteck an. Legen Sie diesen Parameter auf NULL fest, um das gesamte Bild anzugeben.

Filterung [ In]

Typ: DWORD

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 signifikant und sollte in der Regel für nicht transparente Farbschlüssel auf FF festgelegt werden. Bei opakem Schwarz ist der Wert also gleich 0xFF000000.

pSrcInfo [ in, out]

Typ: D3DXIMAGE _ INFO*

Zeiger auf eine D3DXIMAGE _ INFO-Struktur, die mit einer Beschreibung der Daten in der Quellbilddatei gefüllt werden soll, oder NULL.

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

Die Compilereinstellung bestimmt auch die Funktionsversion. Wenn Unicode definiert ist, wird der Funktionsaufruf in D3DXLoadSurfaceFromFileW aufgelöst. Andernfalls wird der Funktionsaufruf in D3DXLoadSurfaceFromFileA aufgelöst, da ANSI-Zeichenfolgen verwendet werden.

Diese Funktion verarbeitet die Konvertierung in und aus komprimierten Texturformaten und unterstützt die folgenden Dateiformate: .bmp, .dds, .dib, .hdr, .jpg, .pfm, .png, .ppm und .tga. Siehe D3DXIMAGE _ FILEFORMAT.

Das Schreiben in eine Oberfläche ungleich null führt nicht dazu, dass das geänderte Rechteck aktualisiert wird. Wenn D3DXLoadSurfaceFromFile 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
D3dx9tex.h
Bibliothek
D3dx9.lib

Siehe auch

Texturfunktionen in D3DX 9