D3DXLoadVolumeFromMemory-Funktion

Artikel
06/13/2023

Lädt ein Volume aus dem Arbeitsspeicher.

Syntax

HRESULT D3DXLoadVolumeFromMemory(
  _In_       LPDIRECT3DVOLUME9 pDestVolume,
  _In_ const PALETTEENTRY      *pDestPalette,
  _In_ const D3DBOX            *pDestBox,
  _In_       LPCVOID           pSrcMemory,
  _In_       D3DFORMAT         SrcFormat,
  _In_       UINT              SrcRowPitch,
  _In_       UINT              SrcSlicePitch,
  _In_ const PALETTEENTRY      *pSrcPalette,
  _In_ const D3DBOX            *pSrcBox,
  _In_       DWORD             Filter,
  _In_       D3DCOLOR          ColorKey
);

Parameter

pDestVolume [in]

Typ: LPDIRECT3DVOLUME9

Zeiger auf eine IDirect3DVolume9-Schnittstelle . Gibt das Zielvolume an, das das Image empfängt.

pDestPalette [in]

Typ: const PALETTEENTRY*

Zeiger auf eine PALETTEENTRY-Struktur , die Zielpalette mit 256 Farben oder NULL.

pDestBox [in]

Typ: const D3DBOX*

Zeiger auf eine D3DBOX-Struktur . Gibt das Zielfeld an. Legen Sie diesen Parameter auf NULL fest, um das gesamte Volume anzugeben.

pSrcMemory [in]

Typ: LPCVOID

Zeiger auf die obere linke Ecke des Quellvolumes im Arbeitsspeicher.

SrcFormat [in]

Typ: D3DFORMAT

Member des aufgezählten D3DFORMAT-Typs , das Pixelformat des Quellvolumes.

SrcRowPitch [in]

Typ: UINT

Pitch des Quellimages in Bytes. Bei DXT-Formaten (komprimierte Texturformate) sollte diese Zahl die Größe einer Zellenzeile in Bytes darstellen.

SrcSlicePitch [in]

Typ: UINT

Pitch des Quellimages in Bytes. Bei DXT-Formaten (komprimierte Texturformate) sollte diese Zahl die Größe eines Slices von Zellen in Bytes darstellen.

pSrcPalette [in]

Typ: const PALETTEENTRY*

Zeiger auf eine PALETTEENTRY-Struktur , die Quellpalette mit 256 Farben oder NULL.

pSrcBox [in]

Typ: const D3DBOX*

Zeiger auf eine D3DBOX-Struktur . Gibt das Quellfeld an. NULL ist kein gültiger Wert für diesen Parameter.

Filter [in]

Typ: DWORD

Eine Kombination aus einem oder mehreren D3DX_FILTER steuern, wie das Bild gefiltert wird. Das Angeben D3DX_DEFAULT für diesen Parameter entspricht der Angabe D3DX_FILTER_TRIANGLE | D3DX_FILTER_DITHER.

ColorKey [in]

Typ: D3DCOLOR

D3DCOLOR-Wert , der durch transparentes Schwarz ersetzt werden soll, oder 0, um den Farbschlüssel zu deaktivieren. Dies ist immer eine 32-Bit-ARGB-Farbe, unabhängig vom Quellbildformat. Alpha ist signifikant und sollte normalerweise für undurchsichtige Farbtasten auf FF festgelegt werden. Für undurchsichtiges Schwarz wäre der Wert also gleich 0xFF000000.

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, D3DXERR_INVALIDDATA.

Bemerkungen

Das Schreiben auf eine Oberfläche der Volumetextur ohne Ebene 0 führt nicht dazu, dass das modifiziert Rechteck aktualisiert wird. Wenn D3DXLoadVolumeFromMemory aufgerufen wird und die Textur nicht bereits modifiziert wurde (dies ist in normalen Verwendungsszenarien unwahrscheinlich), muss die Anwendung IDirect3DVolumeTexture9::AddDirtyBox für die Volumetextur explizit aufrufen.

Anforderungen

Anforderung	Wert
Header	D3dx9tex.h
Bibliothek	D3dx9.lib

Siehe auch

D3DXLoadVolumeFromFile
D3DXLoadVolumeFromResource
D3DXLoadVolumeFromVolume
Texturfunktionen in D3DX 9

Share via