D3DXCreateTextureFromFile-Funktion

Erstellt eine Textur aus einer Datei.

Syntax

HRESULT D3DXCreateTextureFromFile(
  _In_  LPDIRECT3DDEVICE9  pDevice,
  _In_  LPCTSTR            pSrcFile,
  _Out_ LPDIRECT3DTEXTURE9 *ppTexture
);

Parameter

pDevice [ In]

Typ: LPDIRECT3DDEVICE9

Zeiger auf eine IDirect3DDevice9-Schnittstelle, die das Gerät darstellt, das der Textur zugeordnet werden soll.

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.

ppTexture [ out]

Typ: LPDIRECT3DTEXTURE9*

Adresse eines Zeigers auf eine IDirect3DTexture9-Schnittstelle, die das erstellte Texturobjekt darstellt.

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 _ NOTAVAILABLE, D3DERR _ OUTOFVIDEOMEMORY, D3DERR _ INVALIDCALL, D3DXERR _ INVALIDDATA, E _ OUTOFMEMORY.

Hinweise

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

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

Die Funktion entspricht D3DXCreateTextureFromFileEx(pDevice, pSrcFile, D3DX _ DEFAULT, D3DX _ DEFAULT, D3DX _ DEFAULT, 0, D3DFMT _ UNKNOWN, D3DPOOL _ MANAGED, D3DX _ DEFAULT, D3DX _ DEFAULT, 0, NULL, NULL, ppTexture).

Bei Mipmapped-Texturen ist jede Ebene automatisch mit der geladenen Textur gefüllt.

Beim Laden von Bildern in mipmapped Texturen können einige Geräte nicht zu einem 1x1-Bild wechseln, und diese Funktion schlägt fehl. In diesem Fall müssen die Images manuell geladen werden.

Beachten Sie, dass eine mit dieser Funktion erstellte Ressource in der Speicherklasse platziert wird, die von D3DPOOL MANAGED bezeichnet _ wird.

Die Filterung wird automatisch auf eine Textur angewendet, die mit dieser Methode erstellt wurde. Die Filterung entspricht D3DX _ FILTER _ TRIANGLE | D3DX _ FILTER _ DITHER in D3DX _ FILTER.

Für die beste Leistung bei Verwendung von D3DXCreateTextureFromFile:

  1. Die Bildskalierung und Formatkonvertierung zur Ladezeit kann langsam sein. Store Bilder in dem Format und der Auflösung, in dem sie verwendet werden. Wenn die Zielhardware eine Leistung von zwei Dimensionen erfordert, erstellen und speichern Sie Bilder mit zwei Dimensionen.
  2. Erwägen Sie die Verwendung von DDS-Dateien (DirectDraw Surface). Da DDS-Dateien verwendet werden können, um jedes Direct3D 9-Texturformat darzustellen, sind sie für D3DX sehr einfach zu lesen. Außerdem können sie Mipmaps speichern, sodass alle Mipmap-Generierungsalgorithmen zum Erstellen der Bilder verwendet werden können.

Anforderungen

Anforderung Wert
Header
D3dx9tex.h
Bibliothek
D3dx9.lib

Weitere Informationen

D3DXCreateTextureFromFileEx

Texturfunktionen in D3DX 9