Méthode IWICPlanarBitmapSourceTransform ::D oesSupportTransform (wincodec.h)
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
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour