IWICPlanarBitmapSourceTransform::D oesSupportTransform-Methode (wincodec.h)

Artikel
03/06/2024

Verwenden Sie diese Methode, um zu bestimmen, ob eine gewünschte planare Ausgabe unterstützt wird, und ermöglichen Sie es dem Aufrufer, einen optimierten Codepfad auszuwählen, falls dies der Fall ist. Andernfalls sollten Aufrufer auf IWICBitmapSourceTransform oder IWICBitmapSource zurückgreifen und verschachtelte Pixel abrufen.

Die folgenden Transformationen können überprüft werden:

Ermitteln Sie, ob die über WICBitmapTransformOptions angegebene Flip/Rotate-Option unterstützt wird.
Ermitteln Sie, ob die angeforderte Konfiguration des planaren Pixelformats unterstützt wird.
Bestimmen Sie die nächstgelegenen Dimensionen, auf die die Implementierung nativ skaliert werden kann, wenn die gewünschten Dimensionen angegeben sind.

Wenn eine Transformation unterstützt wird, gibt diese Methode die Beschreibung der resultierenden Ebenen im pPlaneDescriptions-Parameter zurück .

Syntax

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
);

Parameter

[in, out] puiWidth

Typ: UINT*

Bei der Eingabe die gewünschte Breite. Bei der Ausgabe die unterstützte Breite, die der gewünschten Breite am nächsten kommt; dies ist die gleiche Größe oder größer als die gewünschte Breite.

[in, out] puiHeight

Typ: UINT*

Bei der Eingabe die gewünschte Höhe. Bei der Ausgabe die unterstützte Höhe, die der gewünschten Höhe am nächsten kommt; dies ist die gleiche Größe oder größer als die gewünschte Breite.

dstTransform

Typ: WICBitmapTransformOptions

Der gewünschte Dreh- oder Drehvorgang. In diesem Flag-Parameter können mehrere WICBitmapTransformOptions kombiniert werden. Weitere Informationen finden Sie unter WICBitmapTransformOptions.

dstPlanarOptions

Typ: 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 Subsampling-Verhältnisse beim Herunterskalieren beizubehalten. Standardmäßig versucht der JPEG-Decoder, die Qualität beizubehalten, indem er in einigen Fällen nur die Y-Ebene herunterskaliert und das Bild in 4:4:4-Chroma-Subsampling ändert.

[in] pguidDstFormats

Typ: const WICPixelFormatGUID*

Die angeforderten Pixelformate der jeweiligen Ebenen.

[out] pPlaneDescriptions

Typ: WICBitmapPlaneDescription*

Bei *pfIsSupported == TRUE enthält das Array der Ebenenbeschreibungen die Größe und das Format der einzelnen Ebenen.

WIC JPEG-Decoder: Die Cb- und Cr-Ebenen können aufgrund von Chroma-Subsampling eine andere Größe als die von puiWidth und puiHeight zurückgegebenen Werte aufweisen.

cPlanes

Typ: UINT

Die Anzahl der angeforderten Komponentenebenen.

[out] pfIsSupported

Typ: BOOL*

Legen Sie auf TRUE fest, wenn die angeforderten Transformationen nativ unterstützt werden.

Rückgabewert

Typ: HRESULT

Überprüfen Sie den Wert von pfIsSupported , um festzustellen, ob die Transformation über IWICPlanarBitmapSourceTransform::CopyPixels unterstützt wird. Wenn diese Methode fehlschlägt, werden die Ausgabeparameter für Breite, Höhe und Ebenenbeschreibungen null initialisiert. Andere Rückgabewerte weisen auf Fehler hin.

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

IWicPlanarBitmapSourceTransform::CopyPixels

WICBitmapPlaneDescription

WICBitmapTransformOptions