IWICDdsDecoder::GetFrame-Methode (wincodec.h)
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 |