IDirect3DDevice9::CreateCubeTexture-Methode (d3d9helper.h)

Artikel
08/23/2023

Erstellt eine Cubetexturressource.

Syntax

HRESULT CreateCubeTexture(
  [in]          UINT                  EdgeLength,
  [in]          UINT                  Levels,
  [in]          DWORD                 Usage,
  [in]          D3DFORMAT             Format,
  [in]          D3DPOOL               Pool,
  [out, retval] IDirect3DCubeTexture9 **ppCubeTexture,
  [in]          HANDLE                *pSharedHandle
);

Parameter

[in] EdgeLength

Typ: UINT

Größe der Kanten aller Flächen der obersten Ebene der Würfeltextur. Die Pixeldimensionen der nachfolgenden Ebenen jedes Gesichts sind der abgeschnittene Wert der Hälfte der Pixeldimension der vorherigen Ebene (unabhängig). Jede Dimension klemmt bei einer Größe von 1 Pixel. Wenn also die Division durch 2 0 (null) ergibt, wird stattdessen 1 genommen.

[in] Levels

Typ: UINT

Anzahl der Ebenen in den einzelnen Gesichtern der Würfeltextur. Wenn dies 0 ist, generiert Direct3D alle Cubetexturunterebenen bis zu 1 x 1 Pixel für jedes Gesicht für Hardware, die mipmappenbasierte Cubetexturen unterstützt. Rufen Sie IDirect3DBaseTexture9::GetLevelCount auf, um die Anzahl der generierten Ebenen anzuzeigen.

[in] Usage

Typ: DWORD

Die Verwendung kann 0 sein, was keinen Nutzungswert angibt. Wenn die Verwendung jedoch gewünscht ist, verwenden Sie eine Kombination aus einer oder mehreren D3DUSAGE-Konstanten . Es empfiehlt sich, den Verwendungsparameter in CreateCubeTexture mit den Verhaltensflags in IDirect3D9::CreateDevice abzugleichen. Weitere Informationen finden Sie in den Hinweisen.

[in] Format

Typ: D3DFORMAT

Mitglied des aufgezählten D3DFORMAT-Typs , der das Format aller Ebenen in allen Gesichtern der Cubetextur beschreibt.

[in] Pool

Typ: D3DPOOL

Mitglied des aufgezählten D3DPOOL-Typs , der die Speicherklasse beschreibt, in der die Cubetextur platziert werden soll.

[out, retval] ppCubeTexture

Typ: IDirect3DCubeTexture9**

Adresse eines Zeigers auf eine IDirect3DCubeTexture9-Schnittstelle , die die erstellte Cubetexturressource darstellt.

[in] pSharedHandle

Typ: HANDLE*

Reserviert. Legen Sie diesen Parameter auf NULL fest. Dieser Parameter kann in Direct3D 9 für Windows Vista zum Freigeben von Ressourcen verwendet werden.

Rückgabewert

Typ: HRESULT

Wenn die Methode erfolgreich ist, wird der Rückgabewert D3D_OK. Wenn die Methode fehlschlägt, kann der Rückgabewert einer der folgenden sein: D3DERR_INVALIDCALL, D3DERR_OUTOFVIDEOMEMORY, E_OUTOFMEMORY.

Hinweise

Eine mipmap (Textur) ist eine Sammlung von sukzessive herunterstempelten (mipmapped) Oberflächen. Andererseits ist eine Cubetextur (erstellt von IDirect3DDevice9::CreateCubeTexture) eine Sammlung von sechs Texturen (mipmaps), eine für jedes Gesicht. Alle Gesichter müssen in der Würfeltextur vorhanden sein. Außerdem muss eine Cubezuordnungsoberfläche die gleiche Pixelgröße in allen drei Dimensionen (x, y und z) aufweisen.

Eine Anwendung kann die Unterstützung für die automatische Generierung von Mipmaps (Direct3D 9) in einem bestimmten Format ermitteln, indem sie IDirect3D9::CheckDeviceFormat mit D3DUSAGE_AUTOGENMIPMAP aufruft . Wenn IDirect3D9::CheckDeviceFormat D3DOK_NOAUTOGEN zurückgibt, ist IDirect3DDevice9::CreateCubeTexture erfolgreich, gibt jedoch eine einstufige Textur zurück.