Méthode IWICDdsDecoder ::GetFrame (wincodec.h)
Récupère le cadre spécifié de l’image DDS.
Syntaxe
HRESULT GetFrame(
[in] UINT arrayIndex,
[in] UINT mipLevel,
[in] UINT sliceIndex,
[out] IWICBitmapFrameDecode **ppIBitmapFrame
);
Paramètres
[in] arrayIndex
Type : UINT
Index demandé dans le tableau de textures.
[in] mipLevel
Type : UINT
Niveau mip demandé.
[in] sliceIndex
Type : UINT
Tranche demandée dans la texture 3D.
[out] ppIBitmapFrame
Type : IWICBitmapFrameDecode**
Pointeur vers un objet IWICBitmapFrameDecode .
Valeur retournée
Type : HRESULT
Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.
Remarques
Un fichier DDS peut contenir plusieurs images organisées dans une hiérarchie à trois niveaux. Tout d’abord, le fichier DDS peut contenir plusieurs textures dans un tableau de textures. Deuxièmement, chaque texture peut avoir plusieurs niveaux de mip. Enfin, la texture peut être une texture 3D (volume) et avoir plusieurs tranches, chacune d’elles étant une texture 2D. Pour plus d’informations, consultez la documentation DDS .
WIC mappe cette hiérarchie à trois niveaux dans un tableau linéaire de IWICBitmapFrameDecode, accessible via IWICBitmapDecoder ::GetFrame. Toutefois, déterminer quel frame correspond à une triade de valeur arrayIndex, mipLevel et sliceIndex n’est pas trivial, car chaque niveau mip d’une texture 3D a une profondeur différente (nombre de tranches). Cette méthode offre une commodité supplémentaire par rapport à IWICBitmapDecoder ::GetFrame pour les images DDS en calculant la trame correcte en fonction des trois index.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 8.1 [applications de bureau | Applications UWP] |
| Serveur minimal pris en charge | Windows Server 2012 R2 [applications de bureau | Applications UWP] |
| Plateforme cible | Windows |
| En-tête | wincodec.h |
| Bibliothèque | Windowscodecs.lib |
| DLL | Windowscodecs.dll |