D3DXLoadVolumeFromResource-Funktion

Artikel
06/13/2023

Lädt ein Volume aus einer Ressource.

Syntax

HRESULT D3DXLoadVolumeFromResource(
  _In_       LPDIRECT3DVOLUME9 pDestVolume,
  _In_ const PALETTEENTRY      *pDestPalette,
  _In_ const D3DBOX            *pDestBox,
  _In_       HMODULE           hSrcModule,
  _In_       LPCSTR            pSrcResource,
  _In_ const D3DBOX            *pSrcBox,
  _In_       DWORD             Filter,
  _In_       D3DCOLOR          ColorKey,
  _In_       D3DXIMAGE_INFO    *pSrcInfo
);

Parameter

pDestVolume [in]

Typ: LPDIRECT3DVOLUME9

Zeiger auf eine IDirect3DVolume9-Schnittstelle . Gibt das Zielvolume an.

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.

hSrcModule [in]

Typ: HMODULE

Behandeln Sie das Modul, in dem sich die Ressource befindet, oder NULL für ein Modul, das dem Image zugeordnet ist, das das Betriebssystem zum Erstellen des aktuellen Prozesses verwendet hat.

pSrcResource [in]

Typ: LPCSTR

Zeiger auf eine Zeichenfolge, die den Dateinamen des Quellimages angibt. Wenn UNICODE oder _UNICODE definiert sind, lautet dieser Parametertyp LPCWSTR, andernfalls ist der Typ LPCSTR.

pSrcBox [in]

Typ: const D3DBOX*

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

Filter [in]

Typ: DWORD

Kombination aus einem oder mehreren D3DX_FILTER, die 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.

pSrcInfo [in]

Typ: D3DXIMAGE_INFO*

Zeiger auf eine D3DXIMAGE_INFO Struktur, die mit einer Beschreibung der Daten in der Quellbilddatei oder NULL gefüllt werden soll.

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

Die geladene Ressource muss eine Bitmapressource (RT_BITMAP) sein.

Diese Funktion verarbeitet die Konvertierung in und aus komprimierten Texturformaten.

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

Diese Funktion unterstützt sowohl Unicode- als auch ANSI-Zeichenfolgen.

Anforderungen

Anforderung	Wert
Header	D3dx9tex.h
Bibliothek	D3dx9.lib

Siehe auch

D3DXLoadVolumeFromFile
D3DXLoadVolumeFromFileInMemory
D3DXLoadVolumeFromMemory
D3DXLoadVolumeFromVolume
Texturfunktionen in D3DX 9

Share via