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:

Der pDstPlanes-Parameter unterstützt die folgenden Pixelformate.

Anforderungen

Weitere Informationen

IWICPlanarBitmapSourceTransform