D3DXCreateCubeTexture-Funktion
Erstellt eine leere Cubetextur und passt die aufrufenden Parameter nach Bedarf an.
Syntax
HRESULT D3DXCreateCubeTexture(
_In_ LPDIRECT3DDEVICE9 pDevice,
_In_ UINT Size,
_In_ UINT MipLevels,
_In_ DWORD Usage,
_In_ D3DFORMAT Format,
_In_ D3DPOOL Pool,
_Out_ LPDIRECT3DCUBETEXTURE9 *ppCubeTexture
);
Parameter
-
pDevice [in]
-
Typ: LPDIRECT3DDEVICE9
Zeiger auf eine IDirect3DDevice9-Schnittstelle , die das Gerät darstellt, das der Textur zugeordnet werden soll.
-
Größe [in]
-
Typ: UINT
Breite und Höhe der Cubetextur in Pixel. Wenn die Cubetextur beispielsweise ein Würfel mit 8 x 8 Pixeln ist, sollte der Wert für diesen Parameter 8 sein.
-
MipLevels [in]
-
Typ: UINT
Anzahl der angeforderten MIP-Ebenen. Wenn dieser Wert null oder D3DX_DEFAULT ist, wird eine vollständige Mipmap-Kette erstellt.
-
Verwendung [in]
-
Typ: DWORD
0, D3DUSAGE_RENDERTARGET oder D3DUSAGE_DYNAMIC. Durch Festlegen dieses Flags auf D3DUSAGE_RENDERTARGET wird angegeben, dass die Oberfläche als Renderziel verwendet werden soll. Die Ressource kann dann an den pNewRenderTarget-Parameter der SetRenderTarget-Methode übergeben werden. Wenn D3DUSAGE_RENDERTARGET angegeben ist, sollte die Anwendung überprüfen, ob das Gerät diesen Vorgang unterstützt, indem CheckDeviceFormat aufgerufen wird. Weitere Informationen zur Verwendung dynamischer Texturen finden Sie unter Verwenden dynamischer Texturen.
-
Formatieren [in]
-
Typ: D3DFORMAT
Mitglied des aufgezählten D3DFORMAT-Typs , der das angeforderte Pixelformat für die Cubetextur beschreibt. Die zurückgegebene Cubetextur hat möglicherweise ein anderes Format als das durch Format angegebene Format. Anwendungen sollten das Format der zurückgegebenen Cubetextur überprüfen.
-
Pool [in]
-
Typ: D3DPOOL
Mitglied des aufgezählten D3DPOOL-Typs , der die Speicherklasse beschreibt, in der die Cubetextur platziert werden soll.
-
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 sein: D3DERR_INVALIDCALL, D3DERR_NOTAVAILABLE, D3DERR_OUTOFVIDEOMEMORY, E_OUTOFMEMORY.
Bemerkungen
Cubetexturen unterscheiden sich von anderen Oberflächen darin, dass es sich um Sammlungen von Oberflächen handelt.
Intern verwendet D3DXCreateCubeTexture D3DXCheckCubeTextureRequirements , um die aufrufenden Parameter anzupassen. Daher sind Aufrufe von D3DXCreateCubeTexture häufig erfolgreich, wenn Aufrufe von CreateCubeTexture fehlschlagen würden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header |
|
| Bibliothek |
|
Siehe auch