Método IXpsRasterizationFactory2::CreateRasterizer (xpsrassvc.h)

Artigo
02/27/2024

O método CreateRasterizer cria um objeto rasterizador XPS que pode converter conteúdo de XPS em PWG Raster usando o Serviço de Rasterização XPS. O PWG Raster dá suporte a DPIs não quadrados.

Sintaxe

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

Parâmetros

[in, optional] xpsPage

Ponteiro para um objeto IXpsOMPage que representa a página fixa XPS a ser renderizada. Esse objeto encapsula uma seção FixedPage de um documento XPS.

[in] DPIX

Pontos por polegada que é aplicado à dimensão x do bitmap de saída rasterizado. O valor de DPI é a resolução do dispositivo que deve imprimir ou exibir a página fixa XPS.

[in] DPIY

Pontos por polegada que é aplicado à dimensão y do bitmap de saída rasterizado.

[in] nonTextRenderingMode

Modo de renderização para itens nontext na saída rasterizada. Esse parâmetro indica se a saída suavizada deve ser gerada. Defina esse parâmetro como um dos seguintes valores de enumeração XPSRAS_RENDERING_MODE :

XPSRAS_RENDERING_MODE_ANTIALIASED
XPSRAS_RENDERING_MODE_ALIASED

[in] textRenderingMode

Modo de renderização para texto na saída rasterizada. Esse parâmetro indica se a saída suavizada deve ser gerada. Defina esse parâmetro como um dos seguintes valores de enumeração XPSRAS_RENDERING_MODE:

XPSRAS_RENDERING_MODE_ANTIALIASED
XPSRAS_RENDERING_MODE_ALIASED

[in] pixelFormat

Permite que um chamador selecione o formato de pixel usado pelo IWICBitmap retornado por IXpsRasterizer::RasterizeRect. Defina esse parâmetro como um dos seguintes valores de enumeração 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

Permite que um chamador selecione a cor da tela de fundo. Defina esse parâmetro como um dos seguintes valores de enumeração XPSRAS_BACKGROUND_COLOR :

XPSRAS_BACKGROUND_COLOR_TRANSPARENT
XPSRAS_BACKGROUND_COLOR_OPAQUE
A cor da tela de fundo padrão é XPSRAS_BACKGROUND_COLOR_TRANSPARENT.

[out, optional] ppIXpsRasterizer

Esse parâmetro aponta para um local no qual o método grava um ponteiro para a interface IXpsRasterizer do objeto rasterizador XPS recém-criado. Se o método falhar, ele gravará NULL nesse local e retornará um código de erro.

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 10
Plataforma de Destino	Área de Trabalho
Cabeçalho	xpsrassvc.h (inclua Xpsrassvc.h)

Confira também

IXpsRasterizationFactory2

Compartilhar via