Método IWICPlanarBitmapSourceTransform::D oesSupportTransform (wincodec.h)

Artículo
03/13/2024

Use este método para determinar si se admite una salida planar deseada y permitir que el autor de la llamada elija una ruta de acceso de código optimizada si es así. De lo contrario, los llamadores deben recurrir a IWICBitmapSourceTransform o IWICBitmapSource y recuperar píxeles intercalados.

Se pueden comprobar las siguientes transformaciones:

Determine si se admite la opción de volteo/giro especificada mediante WICBitmapTransformOptions .
Determine si se admite la configuración de formato de píxel planar solicitada.
Determine las dimensiones más cercanas que la implementación puede escalar de forma nativa para dadas las dimensiones deseadas.

Cuando se admite una transformación, este método devuelve la descripción de los planos resultantes en el parámetro pPlaneDescriptions .

Sintaxis

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

Parámetros

[in, out] puiWidth

Tipo: UINT*

En la entrada, el ancho deseado. En la salida, el ancho admitido más cercano al ancho deseado; es el mismo tamaño o mayor que el ancho deseado.

[in, out] puiHeight

Tipo: UINT*

En la entrada, el alto deseado. En la salida, el alto admitido más cercano al alto deseado; es el mismo tamaño o mayor que el ancho deseado.

dstTransform

Tipo: WICBitmapTransformOptions

La operación de rotación o volteo deseada. Varios WICBitmapTransformOptions se pueden combinar en este parámetro de marca. Consulte WICBitmapTransformOptions.

dstPlanarOptions

Tipo: WICPlanarOptions

Se usa para especificar opciones de configuración adicionales para la transformación. Consulte WICPlanarOptions para obtener más detalles.

Descodificador JPEG de WIC:

WiCPlanarOptionsPreserveSubsampling se puede especificar para conservar las relaciones de submuestreo cuando se reduce el escalado. De forma predeterminada, el descodificador JPEG intenta conservar la calidad mediante el escalado descendente solo del plano Y en algunos casos, cambiando la imagen a submuestreo cromático 4:4:4.

[in] pguidDstFormats

Tipo: const WICPixelFormatGUID*

Formatos de píxel solicitados de los planos respectivos.

[out] pPlaneDescriptions

Tipo: WICBitmapPlaneDescription*

Cuando *pfIsSupported == TRUE, la matriz de descripciones del plano contiene el tamaño y el formato de cada uno de los planos.

Descodificador JPEG de WIC: los planos Cb y Cr pueden ser de un tamaño diferente de los valores devueltos por puiWidth y puiHeight debido al submuestreo cromático.

cPlanes

Tipo: UINT

Número de planos de componente solicitados.

[out] pfIsSupported

Tipo: BOOL*

Se establece en TRUE si se admiten de forma nativa las transformaciones solicitadas.

Valor devuelto

Tipo: HRESULT

Compruebe el valor de pfIsSupported para determinar si la transformación se admite a través de IWICPlanarBitmapSourceTransform::CopyPixels. Si se produce un error en este método, los parámetros de salida para las descripciones de ancho, alto y plano no se inicializan. Otros valores devueltos indican un error.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8.1 [aplicaciones de escritorio \| Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2012 R2 [aplicaciones de escritorio \| Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	wincodec.h
Library	Windowscodecs.lib
Archivo DLL	Windowscodecs.dll

Consulte también

IWICPlanarBitmapSourceTransform

IWicPlanarBitmapSourceTransform::CopyPixels

WICBitmapPlaneDescription

WICBitmapTransformOptions