IDirect3DDevice9::CreateVolumeTexture-Methode (d3d9helper.h)

Artikel
02/28/2024

Erstellt eine Volumetexturressource.

Syntax

HRESULT CreateVolumeTexture(
  [in]          UINT                    Width,
  [in]          UINT                    Height,
  [in]          UINT                    Depth,
  [in]          UINT                    Levels,
  [in]          DWORD                   Usage,
  [in]          D3DFORMAT               Format,
  [in]          D3DPOOL                 Pool,
  [out, retval] IDirect3DVolumeTexture9 **ppVolumeTexture,
  [in]          HANDLE                  *pSharedHandle
);

Parameter

[in] Width

Typ: UINT

Breite der obersten Ebene der Volumetextur in Pixel. Dieser Wert muss eine Stärke von zwei sein, wenn der D3DPTEXTURECAPS_VOLUMEMAP_POW2 Member von D3DCAPS9 festgelegt ist. Die Pixeldimensionen der nachfolgenden Ebenen 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 zwei zu 0 (null) führt, wird stattdessen 1 genommen. Die maximale Dimension, die ein Treiber unterstützt (für Breite, Höhe und Tiefe), finden Sie in MaxVolumeExtent in D3DCAPS9.

[in] Height

Typ: UINT

Höhe der obersten Ebene der Volumetextur in Pixel. Dieser Wert muss eine Stärke von zwei sein, wenn der D3DPTEXTURECAPS_VOLUMEMAP_POW2 Member von D3DCAPS9 festgelegt ist. Die Pixeldimensionen der nachfolgenden Ebenen 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. Die maximale Dimension, die ein Treiber unterstützt (für Breite, Höhe und Tiefe), finden Sie in MaxVolumeExtent in D3DCAPS9.

[in] Depth

Typ: UINT

Tiefe der obersten Ebene der Volumetextur in Pixel. Dieser Wert muss eine Stärke von zwei sein, wenn der D3DPTEXTURECAPS_VOLUMEMAP_POW2 Member von D3DCAPS9 festgelegt ist. Die Pixeldimensionen der nachfolgenden Ebenen 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. Die maximale Dimension, die ein Treiber unterstützt (für Breite, Höhe und Tiefe), finden Sie in MaxVolumeExtent in D3DCAPS9.

[in] Levels

Typ: UINT

Anzahl der Ebenen in der Textur. Wenn dieser Wert 0 ist, generiert Direct3D alle Texturunterebenen bis zu 1 x 1 Pixel für Hardware, die mipmappenbasierte Volumetexturen 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 gewünscht ist, verwenden Sie D3DUSAGE_DYNAMIC oder D3DUSAGE_SOFTWAREPROCESSING. Weitere Informationen finden Sie unter D3DUSAGE.

[in] Format

Typ: D3DFORMAT

Member des D3DFORMAT aufgezählten Typs, der das Format aller Ebenen in der Volumetextur beschreibt.

[in] Pool

Typ: D3DPOOL

Member des D3DPOOL aufgezählten Typs, der die Speicherklasse beschreibt, in der die Volumetextur platziert werden soll.

[out, retval] ppVolumeTexture

Typ: IDirect3DVolumeTexture9**

Adresse eines Zeigers auf eine IDirect3DVolumeTexture9-Schnittstelle , die die erstellte Volumetexturressource 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.