Compartir a través de

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

  • Artículo

El método CreateRasterizer crea un objeto rasterizador XPS que puede convertir contenido de XPS a PWG Raster con el servicio de rasterización XPS. PWG Raster admite DPIs no cuadradas.

Sintaxis

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

Puntero a un objeto IXpsOMPage que representa la página fija XPS que se va a representar. Este objeto encapsula una sección FixedPage de un documento XPS.

[in] DPIX

Puntos por pulgada que se aplican a la dimensión x del mapa de bits de salida rasterizado. El valor de PPP es la resolución del dispositivo que se va a imprimir o mostrar la página fija XPS.

[in] DPIY

Puntos por pulgada que se aplican a la dimensión y del mapa de bits de salida rasterizado.

[in] nonTextRenderingMode

Modo de representación para elementos que no son de texto en la salida rasterizada. Este parámetro indica si se va a generar una salida antialiased. Establezca este parámetro en uno de los siguientes valores de enumeración XPSRAS_RENDERING_MODE:

  • XPSRAS_RENDERING_MODE_ANTIALIASED

  • XPSRAS_RENDERING_MODE_ALIASED

[in] textRenderingMode

Modo de representación para texto en la salida rasterizada. Este parámetro indica si se va a generar una salida antialiased. Establezca este parámetro en uno de los siguientes valores de enumeración XPSRAS_RENDERING_MODE:

  • XPSRAS_RENDERING_MODE_ANTIALIASED

  • XPSRAS_RENDERING_MODE_ALIASED

[in] pixelFormat

Permite que un llamador seleccione el formato de píxel usado por el IWICBitmap devuelto por IXpsRasterizer::RasterizeRect. Establezca este parámetro en uno de los siguientes valores de enumeración 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 un autor de la llamada seleccione el color de fondo. Establezca este parámetro en uno de los siguientes valores de enumeración XPSRAS_BACKGROUND_COLOR :

  • XPSRAS_BACKGROUND_COLOR_TRANSPARENT

  • XPSRAS_BACKGROUND_COLOR_OPAQUE

  • El color de fondo predeterminado es XPSRAS_BACKGROUND_COLOR_TRANSPARENT.

[out, optional] ppIXpsRasterizer

Este parámetro apunta a una ubicación en la que el método escribe un puntero a la interfaz IXpsRasterizer del objeto rasterizador XPS recién creado. Si se produce un error en el método, escribe NULL en esta ubicación y devuelve un código de error.

Valor devuelto

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 10
Plataforma de destino Escritorio
Encabezado xpsrassvc.h (incluye Xpsrassvc.h)

Consulte también

IXpsRasterizationFactory2