IWICPlanarBitmapSourceTransform：:D oesSupportTransform 方法 (wincodec.h)

  • 项目

使用此方法可确定是否支持所需的平面输出，并允许调用方选择优化的代码路径（如果支持）。 否则，调用方应回退到 IWICBitmapSourceTransform 或 IWICBitmapSource 并检索交错像素。

可以检查以下转换：

  • 确定是否支持通过 WICBitmapTransformOptions 指定的翻转/旋转选项。
  • 确定是否支持请求的平面像素格式配置。
  • 确定实现可以本机缩放到给定所需维度的最接近维度。

如果支持转换，此方法将在 pPlaneDescriptions 参数中返回生成的平面的说明。

语法

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

参数

[in, out] puiWidth

类型： UINT*

输入时，为所需的宽度。 输出时，最接近所需宽度的支持宽度;这与所需宽度相同或更大。

[in, out] puiHeight

类型： UINT*

输入时，为所需的高度。 输出时，最接近所需高度的支持高度;这与所需宽度相同或更大。

dstTransform

类型： WICBitmapTransformOptions

所需的旋转或翻转操作。 可以在此标志参数中组合多个 WICBitmapTransformOptions ，请参阅 WICBitmapTransformOptions。

dstPlanarOptions

类型： WICPlanarOptions

用于指定转换的其他配置选项。 有关更多详细信息，请参阅 WICPlanarOptions 。

WIC JPEG 解码器：

可以指定 WICPlanarOptionsPreserveSubsampling，以在缩减时保留子采样比率。 默认情况下，JPEG 解码器尝试通过在某些情况下仅缩减 Y 平面来保持质量，将图像更改为 4：4：4 色度子采样。

[in] pguidDstFormats

类型： const WICPixelFormatGUID*

相应平面的请求像素格式。

[out] pPlaneDescriptions

类型： WICBitmapPlaneDescription*

当 *pfIsSupported == TRUE 时，平面说明数组包含每个平面的大小和格式。

WIC JPEG 解码器：由于色度子采样，Cb 和 Cr 平面的大小可能不同于 puiWidth 和 puiHeight 返回的值。

cPlanes

类型： UINT

请求的组件平面数。

[out] pfIsSupported

类型： BOOL*

如果本机支持请求的转换，则设置为 TRUE。

返回值

类型： HRESULT

检查 pfIsSupported 的值，以确定是否通过 IWICPlanarBitmapSourceTransform：：CopyPixels 支持转换。 如果此方法失败，则宽度、高度和平面说明的输出参数初始化为零。 其他返回值表示失败。

要求

要求 值
最低受支持的客户端 Windows 8.1 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2012 R2 [桌面应用 |UWP 应用]
目标平台 Windows
标头 wincodec.h
Library Windowscodecs.lib
DLL Windowscodecs.dll

另请参阅

IWICPlanarBitmapSourceTransform

IWicPlanarBitmapSourceTransform：：CopyPixels

WICBitmapPlaneDescription

WICBitmapTransformOptions

WICPlanarOptions