D3DXLoadVolumeFromFile-Funktion
Lädt ein Volume aus einer Datei.
Syntax
HRESULT D3DXLoadVolumeFromFile(
_In_ LPDIRECT3DVOLUME9 pDestVolume,
_In_ const PALETTEENTRY *pDestPalette,
_In_ const D3DBOX *pDestBox,
_In_ LPCTSTR pSrcFile,
_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.
-
pSrcFile [in]
-
Typ: LPCTSTR
Zeiger auf eine Zeichenfolge, die den Dateinamen angibt. Wenn die Compilereinstellungen Unicode erfordern, wird der Datentyp LPCTSTR in LPCWSTR aufgelöst. Andernfalls wird der Zeichenfolgendatentyp in LPCSTR aufgelöst. Siehe Hinweise.
-
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 Compilereinstellung bestimmt auch die Funktionsversion. Wenn Unicode definiert ist, wird der Funktionsaufruf in D3DXLoadVolumeFromFileW aufgelöst. Andernfalls wird der Funktionsaufruf in D3DXLoadVolumeFromFileA aufgelöst, da ANSI-Zeichenfolgen verwendet werden.
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 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 Nutzungsszenarien unwahrscheinlich), muss die Anwendung IDirect3DVolumeTexture9::AddDirtyBox explizit für die Volumetextur aufrufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header |
|
| Bibliothek |
|
Siehe auch