Método IWICPlanarBitmapSourceTransform::D oesSupportTransform (wincodec.h)
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