D3DXCreateCubeTextureFromFile-Funktion
Erstellt eine Cubetextur aus einer Datei.
Syntax
HRESULT D3DXCreateCubeTextureFromFile(
_In_ LPDIRECT3DDEVICE9 pDevice,
_In_ LPCTSTR pSrcFile,
_Out_ LPDIRECT3DCUBETEXTURE9 *ppCubeTexture
);
Parameter
-
pDevice [in]
-
Typ: LPDIRECT3DDEVICE9
Zeiger auf eine IDirect3DDevice9-Schnittstelle , die das Gerät darstellt, das der Cubetextur 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.
-
ppCubeTexture [out]
-
Typ: LPDIRECT3DCUBETEXTURE9*
Adresse eines Zeigers auf eine IDirect3DCubeTexture9-Schnittstelle , die das erstellte Cubetexturobjekt darstellt.
Rückgabewert
Typ: HRESULT
Wenn die Funktion erfolgreich ist, wird der Rückgabewert D3D_OK. Wenn die Funktion fehlschlägt, kann der Rückgabewert einer der folgenden Werte sein: D3DERR_INVALIDCALL, D3DERR_NOTAVAILABLE, D3DERR_OUTOFVIDEOMEMORY, D3DXERR_INVALIDDATA, E_OUTOFMEMORY.
Bemerkungen
Die Compilereinstellung bestimmt auch die Funktionsversion. Wenn Unicode definiert ist, wird der Funktionsaufruf in D3DXCreateCubeTextureFromFileW aufgelöst. Andernfalls wird der Funktionsaufruf in D3DXCreateCubeTextureFromFileA aufgelöst, da ANSI-Zeichenfolgen verwendet werden.
Die Funktion entspricht D3DXCreateCubeTextureFromFileEx(pDevice, pSrcFile, D3DX_DEFAULT, D3DX_DEFAULT, 0, D3DFMT_UNKNOWN, D3DPOOL_MANAGED, D3DX_DEFAULT, D3DX_DEFAULT, 0, NULL, null, ppCubeTexture).
Diese Funktion unterstützt die folgenden Dateiformate: .bmp, .dds, .dib, .hdr, .jpg, .pfm, .png, .ppm und .tga. Siehe D3DXIMAGE_FILEFORMAT.
Beachten Sie, dass eine Ressource, die mit dieser Funktion erstellt wurde, 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 von D3DPOOL_DEFAULT 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.
D3DXCreateCubeTextureFromFile verwendet das DDS-Dateiformat (DirectDraw Surface). Mit dem DirectX-Textur-Editor (Dxtex.exe) können Sie eine Cubezuordnung aus anderen Dateiformaten generieren und im DDS-Dateiformat speichern. Sie können Dxtex.exe abrufen und über das DirectX SDK erfahren. Informationen zum DirectX SDK finden Sie unter Wo ist das DirectX SDK?.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header |
|
| Bibliothek |
|
Siehe auch