Méthode IWICPlanarBitmapSourceTransform ::D oesSupportTransform (wincodec.h)

Article
08/27/2023

Utilisez cette méthode pour déterminer si une sortie planaire souhaitée est prise en charge et permettre à l’appelant de choisir un chemin de code optimisé le cas échéant. Sinon, les appelants doivent revenir à IWICBitmapSourceTransform ou IWICBitmapSource et récupérer des pixels entrelacés.

Les transformations suivantes peuvent être vérifiées :

Déterminez si l’option retourner/pivoter spécifiée via WICBitmapTransformOptions est prise en charge.
Déterminez si la configuration du format de pixel planaire demandée est prise en charge.
Déterminez les dimensions les plus proches que l’implémentation peut mettre à l’échelle en mode natif en fonction des dimensions souhaitées.

Lorsqu’une transformation est prise en charge, cette méthode retourne la description des plans résultants dans le paramètre pPlaneDescriptions .

Syntaxe

HRESULT DoesSupportTransform(
  [in, out] UINT                      *puiWidth,
  [in, out] UINT                      *puiHeight,
            WICBitmapTransformOptions dstTransform,
            WICPlanarOptions          dstPlanarOptions,
  [in]      const WICPixelFormatGUID  *pguidDstFormats,
  [out]     WICBitmapPlaneDescription *pPlaneDescriptions,
            UINT                      cPlanes,
  [out]     BOOL                      *pfIsSupported
);

Paramètres

[in, out] puiWidth

Type : UINT*

En entrée, la largeur souhaitée. En sortie, la largeur prise en charge la plus proche de la largeur souhaitée ; il s’agit de la même taille ou d’une taille supérieure à la largeur souhaitée.

[in, out] puiHeight

Type : UINT*

En entrée, la hauteur souhaitée. En sortie, la hauteur prise en charge la plus proche de la hauteur souhaitée ; il s’agit de la même taille ou d’une taille supérieure à la largeur souhaitée.

dstTransform

Type : WICBitmapTransformOptions

Opération de rotation ou de retournement souhaitée. Plusieurs WICBitmapTransformOptions peuvent être combinés dans ce paramètre d’indicateur. Consultez WICBitmapTransformOptions.

dstPlanarOptions

Type : WICPlanarOptions

Utilisé pour spécifier des options de configuration supplémentaires pour la transformation. Pour plus d’informations, consultez WICPlanarOptions .

Décodeur JPEG WIC :

WICPlanarOptionsPreserveSubsampling peut être spécifié pour conserver les ratios de sous-échantillonnage lors de la mise à l’échelle inférieure. Par défaut, le décodeur JPEG tente de préserver la qualité en mettant à l’échelle inférieure uniquement le plan Y dans certains cas, en modifiant l’image en sous-échantillonnage chroma 4 :4 :4.

[in] pguidDstFormats

Type : const WICPixelFormatGUID*

Formats de pixels demandés pour les plans respectifs.

[out] pPlaneDescriptions

Type : WICBitmapPlaneDescription*

Quand *pfIsSupported == TRUE, le tableau de descriptions de plan contient la taille et le format de chacun des plans.

Décodeur JPEG WIC : les plans Cb et Cr peuvent être d’une taille différente des valeurs retournées par puiWidth et puiHeight en raison du sous-échantillonnage chroma.

cPlanes

Type : UINT

Nombre de plans de composants demandés.

[out] pfIsSupported

Type : BOOL*

Défini sur TRUE si les transformations demandées sont prises en charge en mode natif.

Valeur retournée

Type : HRESULT

Vérifiez la valeur de pfIsSupported pour déterminer si la transformation est prise en charge via IWICPlanarBitmapSourceTransform ::CopyPixels. Si cette méthode échoue, les paramètres de sortie pour les descriptions de largeur, de hauteur et de plan sont initialisés à zéro. D’autres valeurs de retour indiquent un échec.

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

Voir aussi

IWICPlanarBitmapSourceTransform

IWicPlanarBitmapSourceTransform ::CopyPixels

WICBitmapPlaneDescription

WICBitmapTransformOptions

Partager via