IWICPlanarBitmapSourceTransform::CopyPixels-Methode (wincodec.h)

Kopiert Pixel in die Zielebenen. Konfiguriert durch die angegebenen Eingabeparameter.

Wenn eine dstTransform-, Skalierungs- oder Formatkonvertierung angegeben wird, ist cbStride der transformierte Schritt und basiert auf dem Zielpixelformat des pDstPlanes-Parameters , nicht auf dem Pixelformat der ursprünglichen Quelle.

Syntax

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

Parameter

[in] prcSource

Typ: const WICRect*

Das Quellrechteck der zu kopierenden Pixel.

uiWidth

Typ: UINT

Die Breite zum Skalieren der Quell-Bitmap. Dieser Parameter muss gleich einem Wert sein, der über IWICPlanarBitmapSourceTransform:: DoesSupportTransform abgerufen werden kann.

uiHeight

Typ: UINT

Die Höhe, in der die Quellbitbitbit skaliert werden soll. Dieser Parameter muss gleich einem Wert sein, der über IWICPlanarBitmapSourceTransform:: DoesSupportTransform abgerufen werden kann.

dstTransform

Typ: WICBitmapTransformOptions

Die gewünschte Drehung oder Drehung, die vor der Pixelkopie ausgeführt werden soll. Eine Drehung kann mit einem horizontalen oder vertikalen Flip kombiniert werden, siehe WICBitmapTransformOptions.

[in] dstPlanarOptions

Typ: const WICPlanarOptions

Wird verwendet, um zusätzliche Konfigurationsoptionen für die Transformation anzugeben. Weitere Informationen finden Sie unter WICPlanarOptions .

WIC JPEG-Decoder: WICPlanarOptionsPreserveSubsampling kann angegeben werden, um die Untersampling-Verhältnisse beim Herunterskalieren beizubehalten. Standardmäßig versucht der JPEG-Decoder, die Qualität zu erhalten, indem in einigen Fällen nur die Y-Ebene herunterskaliert wird und das Bild in 4:4:4 Chroma-Subsampling geändert wird.

pDstPlanes

Typ: WICBitmapPlane

Gibt das Pixelformat und den Ausgabepuffer für jede Komponentenebene an. Die Anzahl der Ebenen und das Pixelformat jeder Ebene müssen mit Werten übereinstimmen, die über IWICPlanarBitmapSourceTransform::D oesSupportTransform abgerufen werden können.

cPlanes

Typ: UINT

Die Anzahl der Komponentenebenen, die durch den pDstPlanes-Parameter angegeben werden.

Rückgabewert

Typ: HRESULT

Wenn die angegebene Skalierungs-, Flip-/Rotierungs- und planare Formatkonfiguration nicht unterstützt wird, schlägt diese Methode mit WINCODEC_ERR_INVALIDPARAMETER fehl. Sie können überprüfen, ob eine Transformation unterstützt wird, indem Sie IWICPlanarBitmapSourceTransform::D oesSupportTransform aufrufen.

Hinweise

WIC JPEG-Decoder: Je nach konfigurierter Chroma-Untersampling des Bilds gelten für das Quellrechteck die folgenden Einschränkungen:

Chroma-Untersampling x-Koordinate y-Koordinate Farbbreite Chromahöhe
4:2:0 Vielfaches von 2 Vielfaches von 2 lumaWidth / 2 Auf die nächste ganze Zahl aufgerundet. lumaHeight / 2 Auf die nächste ganze Zahl aufgerundet.
4:2:2 Vielfaches von 2 Any lumaWidth / 2 Auf die nächste ganze Zahl aufgerundet. lumaHeight
4:4:4 Any Any llumaWidth llumaHeight
4:4:0 Any Vielfaches von 2 lumaWidth llumaHeight / 2 Auf die nächste ganze Zahl aufgerundet.
 

Der pDstPlanes-Parameter unterstützt die folgenden Pixelformate.

Ebenenanzahl Ebene 1 Ebene 2 Ebene 3
3 GUID_WICPixelFormat8bppY GUID_WICPixelFormat8bppCb GUID_WICPixelFormat8bppCr
2 GUID_WICPixelFormat8bppY GUID_WICPixelFormat16bppCbCr

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8.1 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 R2 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile wincodec.h
Bibliothek Windowscodecs.lib
DLL Windowscodecs.dll

Weitere Informationen

IWICPlanarBitmapSourceTransform