Méthode IWICPlanarBitmapSourceTransform ::CopyPixels (wincodec.h)

Copie les pixels dans les plans de destination. Configuré par les paramètres d’entrée fournis.

Si une conversion dstTransform, de mise à l’échelle ou de format est spécifiée, cbStride est la foulée transformée et est basée sur le format de pixel de destination du paramètre pDstPlanes , et non sur le format de pixel de la source d’origine.

Syntaxe

HRESULT CopyPixels(
  [in] const WICRect             *prcSource,
       UINT                      uiWidth,
       UINT                      uiHeight,
       WICBitmapTransformOptions dstTransform,
  [in] WICPlanarOptions          dstPlanarOptions,
       const WICBitmapPlane      *pDstPlanes,
       UINT                      cPlanes
);

Paramètres

[in] prcSource

Type : const WICRect*

Rectangle source de pixels à copier.

uiWidth

Type : UINT

Largeur de mise à l’échelle de la bitmap source. Ce paramètre doit être égal à une valeur pouvant être obtenue via IWICPlanarBitmapSourceTransform :: DoesSupportTransform.

uiHeight

Type : UINT

Hauteur de mise à l’échelle de la bitmap source. Ce paramètre doit être égal à une valeur pouvant être obtenue via IWICPlanarBitmapSourceTransform :: DoesSupportTransform.

dstTransform

Type : WICBitmapTransformOptions

Rotation ou retournement souhaité à effectuer avant la copie de pixels. Une rotation peut être combinée avec un retournement horizontal ou un retournement vertical. Consultez WICBitmapTransformOptions.

[in] dstPlanarOptions

Type : const WICPlanarOptions

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

Décodeur WIC JPEG : 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 uniquement le plan Y dans certains cas, en modifiant l’image en sous-échantillonnage chromatique 4 :4 :4.

pDstPlanes

Type : WICBitmapPlane

Spécifie le format de pixel et la mémoire tampon de sortie pour chaque plan de composant. Le nombre de plans et le format de pixels de chaque plan doivent correspondre aux valeurs pouvant être obtenues via IWICPlanarBitmapSourceTransform ::D oesSupportTransform.

cPlanes

Type : UINT

Nombre de plans de composants spécifiés par le paramètre pDstPlanes .

Valeur retournée

Type : HRESULT

Si la configuration de mise à l’échelle, de rotation/rotation et de format planaire spécifiée n’est pas prise en charge, cette méthode échoue avec WINCODEC_ERR_INVALIDPARAMETER. Vous pouvez case activée si une transformation est prise en charge en appelant IWICPlanarBitmapSourceTransform ::D oesSupportTransform.

Remarques

Décodeur JPEG WIC : Selon le sous-échantillonnage chromatique configuré de l’image, le rectangle source présente les restrictions suivantes :

Sous-échantillonnage chroma	X Coordinate	Y Coordinate	Largeur chromatique	Hauteur chromatique
4:2:0	Multiple de 2	Multiple de 2	lumaWidth / 2 arrondi à l’entier le plus proche.	lumaHeight / 2 arrondi à l’entier le plus proche.
4:2:2	Multiple de 2	Quelconque	lumaWidth / 2 arrondi à l’entier le plus proche.	lumaHeight
4:4:4	Quelconque	Quelconque	llumaWidth	llumaHeight
4:4:0	Quelconque	Multiple de 2	lumaWidth	llumaHeight / 2 arrondi à l’entier le plus proche.

 

Le paramètre pDstPlanes prend en charge les formats de pixels suivants.

Nombre de plans	Plan 1	Plan 2	Plan 3
3	GUID_WICPixelFormat8bppY	GUID_WICPixelFormat8bppCb	GUID_WICPixelFormat8bppCr
2	GUID_WICPixelFormat8bppY	GUID_WICPixelFormat16bppCbCr	N/A

Spécifications

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