D3DXLoadVolumeFromFileInMemory-Funktion

Lädt ein Volume aus einer Datei im Arbeitsspeicher.

Syntax

HRESULT D3DXLoadVolumeFromFileInMemory(
  _In_       LPDIRECT3DVOLUME9 pDestVolume,
  _In_ const PALETTEENTRY      *pDestPalette,
  _In_ const D3DBOX            *pDestBox,
  _In_       LPCVOID           pSrcData,
  _In_       UINT              SrcDataSize,
  _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 Zielvolumen 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.

pSrcData [ In]

Typ: LPCVOID

Zeiger auf die Datei im Arbeitsspeicher, aus der das Volume geladen werden soll.

SrcDataSize [ In]

Typ: UINT

Größe der Datei im Arbeitsspeicher in Bytes.

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 mindestens einem D3DX-FILTER, _ der steuert, wie das Bild gefiltert wird. Die Angabe von D3DX DEFAULT für diesen Parameter entspricht der Angabe von _ D3DX _ FILTER _ TRIANGLE | D3DX _ FILTER _ DITHER.

ColorKey [ In]

Typ: D3DCOLOR

D3DCOLOR-Wert, der durch transparentes Schwarz ersetzt werden soll, oder 0, um den Colorkey zu deaktivieren. Dies ist immer eine 32-Bit-ARGB-Farbe, unabhängig vom Quellbildformat. Alpha ist wichtig und sollte für nicht transparente Farbtasten in der Regel auf FF festgelegt werden. Daher wäre der Wert für opakes Schwarz gleich 0xFF000000.

pSrcInfo [ In]

Typ: D3DXIMAGE _ INFO*

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

Rückgabewert

Typ: HRESULT

Wenn die Funktion erfolgreich ist, ist der Rückgabewert D3D _ OK. Wenn die Funktion fehlschlägt, kann der Rückgabewert einer der folgenden sein: D3DERR _ INVALIDCALL, D3DXERR _ INVALIDDATA.

Hinweise

Diese Funktion verarbeitet die Konvertierung in und aus komprimierten Texturformaten und unterstützt die folgenden Dateiformate: .bmp, .dds, .dib, .hdr, .jpg, .pfm, .png, .ppm und .tga. Siehe D3DXIMAGE _ FILEFORMAT.

Das Schreiben auf eine Nichtebenenoberfläche der Volumetextur verursacht keine Aktualisierung des geänderten Rechtecks. Wenn D3DXLoadVolumeFromFileInMemory aufgerufen wird und die Textur noch nicht angepasst wurde (dies ist in normalen Verwendungsszenarien unwahrscheinlich), muss die Anwendung explizit IDirect3DVolumeTexture9::AddDirtyBox für die Volumetextur aufrufen.

Anforderungen

Anforderung Wert
Header
D3dx9tex.h
Bibliothek
D3dx9.lib

Siehe auch

D3DXLoadVolumeFromFile

D3DXLoadVolumeFromMemory

D3DXLoadVolumeFromResource

D3DXLoadVolumeFromVolume

Texturfunktionen in D3DX 9