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