Метод IXpsRasterizationFactory2::CreateRasterizer (xpsrassvc.h)

Статья
08/08/2023

Метод CreateRasterizer создает объект растеризатора XPS, который может преобразовывать содержимое из XPS в растр PWG с помощью службы растеризации XPS. PwG Raster поддерживает некверные 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

Указатель на объект IXpsOMPage , представляющий отрисовку предопределенную страницу XPS. Этот объект инкапсулирует раздел FixedPage из документа XPS.

[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

Позволяет вызывающей объекту выбрать формат пикселей, используемый IWICBitmap, возвращаемым IXpsRasterizer::RasterizeRect. Задайте для этого параметра одно из следующих 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

Этот параметр указывает на расположение, в которое метод записывает указатель на интерфейс IXpsRasterizer только что созданного объекта растеризатора XPS. В случае сбоя метода в это расположение записывается значение NULL и возвращается код ошибки.

Возвращаемое значение

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Требования

Требование	Значение
Минимальная версия клиента	Windows 10
Целевая платформа	Персональный компьютер
Верхняя часть	xpsrassvc.h (включая Xpsrassvc.h)

См. также раздел

IXpsRasterizationFactory2

Поделиться через