IWICDdsDecoder::GetFrame-Methode (wincodec.h)

  • Artikel

Ruft den angegebenen Frame des DDS-Images ab.

Syntax

HRESULT GetFrame(
  [in]  UINT                  arrayIndex,
  [in]  UINT                  mipLevel,
  [in]  UINT                  sliceIndex,
  [out] IWICBitmapFrameDecode **ppIBitmapFrame
);

Parameter

[in] arrayIndex

Typ: UINT

Der angeforderte Index innerhalb des Texturarrays.

[in] mipLevel

Typ: UINT

Die angeforderte MIP-Ebene.

[in] sliceIndex

Typ: UINT

Der angeforderte Slice innerhalb der 3D-Textur.

[out] ppIBitmapFrame

Typ: IWICBitmapFrameDecode**

Ein Zeiger auf ein IWICBitmapFrameDecode-Objekt .

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Eine DDS-Datei kann mehrere Bilder enthalten, die in einer dreistufigen Hierarchie organisiert sind. Erstens kann die DDS-Datei mehrere Texturen in einem Texturarray enthalten. Zweitens kann jede Textur mehrere Mip-Ebenen aufweisen. Schließlich kann die Textur eine 3D-Textur (Volumen) sein und mehrere Slices aufweisen, von denen jede eine 2D-Textur ist. Weitere Informationen finden Sie in der DDS-Dokumentation .

WIC ordnet diese Hierarchie mit drei Ebenen einem linearen Array von IWICBitmapFrameDecode zu, auf das über IWICBitmapDecoder::GetFrame zugegriffen werden kann. Das Bestimmen, welcher Frame einer Triade aus arrayIndex, mipLevel und sliceIndex entspricht, ist jedoch nicht trivial, da jede Mip-Ebene einer 3D-Textur eine andere Tiefe (Anzahl von Slices) aufweist. Diese Methode bietet zusätzlichen Komfort gegenüber IWICBitmapDecoder::GetFrame für DDS-Bilder, indem der richtige Frame unter Berücksichtigung der drei Indizes berechnet wird.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8.1 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 R2 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile wincodec.h
Bibliothek Windowscodecs.lib
DLL Windowscodecs.dll

Weitere Informationen

CreateBitmap

ID3D11Device::CreateTexture2D

IWICDdsDecoder

WICDdsFormatInfo