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

Voir aussi

CreateBitmap

ID3D11Device ::CreateTexture2D

IWICDdsDecoder

WICDdsFormatInfo