D3DXCreateVolumeTextureFromFile-Funktion
Erstellt eine Volumetextur aus einer Datei.
Syntax
HRESULT D3DXCreateVolumeTextureFromFile(
_In_ LPDIRECT3DDEVICE9 pDevice,
_In_ LPCTSTR pSrcFile,
_Out_ LPDIRECT3DVOLUMETEXTURE9 *ppVolumeTexture
);
Parameter
-
pDevice [ In]
-
Typ: LPDIRECT3DDEVICE9
Zeiger auf eine IDirect3DDevice9-Schnittstelle, die das Gerät darstellt, das der Volumetextur 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 auflösen. Andernfalls wird der Zeichenfolgendatentyp in LPCSTR auflösen. Siehe Hinweise.
-
ppVolumeTexture [ out]
-
Typ: LPDIRECT3DVOLUMETEXTURE9*
Adresse eines Zeigers auf eine IDirect3DVolumeTexture9-Schnittstelle, die das erstellte Texturobjekt darstellt.
Rückgabewert
Typ: HRESULT
Wenn die Funktion erfolgreich ist, ist der Rückgabewert D3D _ OK. Wenn bei der Funktion ein Fehler auftritt, kann der Rückgabewert einen der folgenden Werte haben: D3DERR _ NOTAVAILABLE, D3DERR _ OUTOFVIDEOMEMORY, D3DERR _ INVALIDCALL, D3DXERR _ INVALIDDATA, E _ OUTOFMEMORY.
Bemerkungen
Die Compilereinstellung bestimmt auch die Funktionsversion. Wenn Unicode definiert ist, wird der Funktionsaufruf in D3DXCreateVolumeTextureFromFileW auflösen. Andernfalls wird der Funktionsaufruf in D3DXCreateVolumeTextureFromFileA aufgelöst, da ANSI-Zeichenfolgen verwendet werden.
Die Funktion entspricht D3DXCreateVolumeTextureFromFileEx(pDevice, pSrcFile, D3DX _ DEFAULT, D3DX _ DEFAULT, D3DX _ DEFAULT, D3DX _ DEFAULT, 0, D3DFMT _ UNKNOWN, D3DPOOL _ MANAGED, D3DX _ DEFAULT, D3DX _ DEFAULT, 0, NULL, NULL, ppVolumeTexture).
Diese Funktion unterstützt die folgenden Dateiformate: .bmp, .dds, .dib, .hdr, .jpg, .pfm, .png, .ppm und .tga. Siehe D3DXIMAGE _ FILEFORMAT.
Bei Mipmapped-Texturen wird 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 Ressource, die mit dieser Funktion erstellt wird, wenn sie von einem IDirect3DDevice9-Objekt aufgerufen wird, in der Speicherklasse platziert wird, die von D3DPOOL MANAGED bezeichnet _ wird. Wenn diese Methode von einem IDirect3DDevice9Ex-Objekt aufgerufen wird, wird die Ressource in der Speicherklasse platziert, die durch D3DPOOL DEFAULT gekennzeichnet _ 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.
Anforderungen
| Anforderungen | Wert |
|---|---|
| Header |
|
| Bibliothek |
|