IXpsRasterizationFactory2：：CreateRasterizer 方法 (xpsrassvc.h)

  • 项目

CreateRasterizer 方法创建一个 XPS 光栅器对象，该对象可以使用 XPS 光栅化服务将内容从 XPS 转换为 PWG 光栅。 PWG 光栅支持非矩形 DPI。

语法

HRESULT CreateRasterizer(
  [in, optional]  IXpsOMPage              *xpsPage,
  [in]            FLOAT                   DPIX,
  [in]            FLOAT                   DPIY,
  [in]            XPSRAS_RENDERING_MODE   nonTextRenderingMode,
  [in]            XPSRAS_RENDERING_MODE   textRenderingMode,
  [in]            XPSRAS_PIXEL_FORMAT     pixelFormat,
  [in]            XPSRAS_BACKGROUND_COLOR backgroundColor,
  [out, optional] IXpsRasterizer          **ppIXpsRasterizer
);

参数

[in, optional] xpsPage

指向表示要呈现的 XPS 固定页的 IXpsOMPage 对象的指针。 此对象封装 XPS 文档中的 FixedPage 节。

[in] DPIX

应用于光栅化输出位图的 x 维度的每英寸点数。 DPI 值是打印或显示 XPS 固定页的设备分辨率。

[in] DPIY

应用于光栅化输出位图的 y 维度的每英寸点数。

[in] nonTextRenderingMode

光栅化输出中非文本项的呈现模式。 此参数指示是否生成抗锯齿输出。 将此参数设置为以下 XPSRAS_RENDERING_MODE 枚举值之一：

  • XPSRAS_RENDERING_MODE_ANTIALIASED

  • XPSRAS_RENDERING_MODE_ALIASED

[in] textRenderingMode

光栅化输出中文本的呈现模式。 此参数指示是否生成抗锯齿输出。 将此参数设置为以下XPSRAS_RENDERING_MODE枚举值之一：

  • XPSRAS_RENDERING_MODE_ANTIALIASED

  • XPSRAS_RENDERING_MODE_ALIASED

[in] pixelFormat

允许调用方选择 IXpsRasterizer：：RasterizeRect 返回的 IWICBitmap 使用的像素格式。 将此参数设置为以下 XPSRAS_PIXEL_FORMAT 枚举值之一：

  • XPSRAS_PIXEL_FORMAT_32BPP_PBGRA_UINT_SRGB

  • XPSRAS_PIXEL_FORMAT_64BPP_PRGBA_HALF_SCRGB

  • XPSRAS_PIXEL_FORMAT_128BPP_PRGBA_FLOAT_SCRGB

[in] backgroundColor

允许调用方选择背景色。 将此参数设置为以下 XPSRAS_BACKGROUND_COLOR 枚举值之一：

  • XPSRAS_BACKGROUND_COLOR_TRANSPARENT

  • XPSRAS_BACKGROUND_COLOR_OPAQUE

  • 默认背景色为XPSRAS_BACKGROUND_COLOR_TRANSPARENT。

[out, optional] ppIXpsRasterizer

此参数指向方法将指针写入到新创建的 XPS 光栅 器对象的 IXpsRasterizer 接口的位置。 如果方法失败，它会将 NULL 写入此位置并返回错误代码。

返回值

如果该方法成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

要求

要求 值
最低受支持的客户端 Windows 10
目标平台 桌面
标头 xpsrasvc.h (包括 Xpsrassvc.h)

另请参阅

IXpsRasterizationFactory2