IXpsRasterizationFactory1::CreateRasterizer method (xpsrassvc.h)

The CreateRasterize method creates an XPS rasterizer object that can handle high precision colors.

Syntax

HRESULT CreateRasterizer(
  [in, optional]  IXpsOMPage            *xpsPage,
  [in]            FLOAT                 DPI,
  [in]            XPSRAS_RENDERING_MODE nonTextRenderingMode,
  [in]            XPSRAS_RENDERING_MODE textRenderingMode,
                  XPSRAS_PIXEL_FORMAT   pixelFormat,
  [out, optional] IXpsRasterizer        **ppIXPSRasterizer
);

Parameters

[in, optional] xpsPage

Pointer to an IXpsOMPage object that represents the XPS fixed page to render. This object encapsulates a FixedPage section from an XPS document. For more information, see IXpsOMPage.

[in] DPI

Dots per inch in the rasterized output. This parameter applies to both the x and y dimensions of the output bitmap. The DPI value is the resolution of the device that is to print or display the XPS fixed page.

[in] nonTextRenderingMode

Rendering mode for nontext items in the rasterized output. This parameter indicates whether to generate antialiased output. Set this parameter to one of the following XPSRAS_RENDERING_MODE enumeration values:

• XPSRAS_RENDERING_MODE_ANTIALIASED

• XPSRAS_RENDERING_MODE_ALIASED

[in] textRenderingMode

Rendering mode for text in the rasterized output. This parameter indicates whether to generate antialiased output. Set this parameter to one of the following XPSRAS_RENDERING_MODE enumeration values:

• XPSRAS_RENDERING_MODE_ANTIALIASED

• XPSRAS_RENDERING_MODE_ALIASED

pixelFormat

The pixelFormat parameter.

[out, optional] ppIXPSRasterizer

This parameter points to a location into which the method writes a pointer to the IXpsRasterizer interface of the newly created XPS rasterizer object. If the method fails, it writes NULL to this location and returns an error code.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Requirements

Requirement	Value
Target Platform	Windows
Header	xpsrassvc.h (include Xpsrassvc.h)

See also

IXPSRasterizationFactory1