Partager via

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

  • Article

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