IXpsRasterizationFactory2::CreateRasterizer-Methode (xpsrassvc.h)

Artikel
02/27/2024

Die CreateRasterizer-Methode erstellt ein XPS-Rasterizer-Objekt, das Mithilfe des XPS-Rasterdiensts Inhalte aus XPS in PWG-Raster konvertieren kann. PWG Raster unterstützt nicht quadratische DPIs.

Syntax

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

Parameter

[in, optional] xpsPage

Zeiger auf ein IXpsOMPage-Objekt , das die zu rendernde XPS-Feste Seite darstellt. Dieses Objekt kapselt einen FixedPage-Abschnitt aus einem XPS-Dokument.

[in] DPIX

Punkte pro Zoll, die auf die x-Dimension der rasterten Ausgabe-Bitmap angewendet wird. Der DPI-Wert ist die Auflösung des Geräts, das die XPS-Feste Seite drucken oder anzeigen soll.

[in] DPIY

Punkte pro Zoll, die auf die y-Dimension der rasterten Ausgabe-Bitmap angewendet wird.

[in] nonTextRenderingMode

Renderingmodus für Nichttextelemente in der gerasterten Ausgabe. Dieser Parameter gibt an, ob eine Antialiased-Ausgabe generiert werden soll. Legen Sie diesen Parameter auf einen der folgenden XPSRAS_RENDERING_MODE Enumerationswerte fest:

XPSRAS_RENDERING_MODE_ANTIALIASED
XPSRAS_RENDERING_MODE_ALIASED

[in] textRenderingMode

Renderingmodus für Text in der gerasterten Ausgabe. Dieser Parameter gibt an, ob eine Antialiased-Ausgabe generiert werden soll. Legen Sie diesen Parameter auf einen der folgenden XPSRAS_RENDERING_MODE Enumerationswerte fest:

XPSRAS_RENDERING_MODE_ANTIALIASED
XPSRAS_RENDERING_MODE_ALIASED

[in] pixelFormat

Ermöglicht einem Aufrufer die Auswahl des Pixelformats, das von der von IXpsRasterizer::RasterizeRect zurückgegebenen IWICBitmap verwendet wird. Legen Sie diesen Parameter auf einen der folgenden XPSRAS_PIXEL_FORMAT Enumerationswerte fest:

XPSRAS_PIXEL_FORMAT_32BPP_PBGRA_UINT_SRGB
XPSRAS_PIXEL_FORMAT_64BPP_PRGBA_HALF_SCRGB
XPSRAS_PIXEL_FORMAT_128BPP_PRGBA_FLOAT_SCRGB

[in] backgroundColor

Ermöglicht einem Aufrufer die Auswahl der Hintergrundfarbe. Legen Sie diesen Parameter auf einen der folgenden XPSRAS_BACKGROUND_COLOR-Enumerationswerte fest:

XPSRAS_BACKGROUND_COLOR_TRANSPARENT
XPSRAS_BACKGROUND_COLOR_OPAQUE
Die Standardhintergrundfarbe ist XPSRAS_BACKGROUND_COLOR_TRANSPARENT.

[out, optional] ppIXpsRasterizer

Dieser Parameter verweist auf eine Position, an der die -Methode einen Zeiger auf die IXpsRasterizer-Schnittstelle des neu erstellten XPS-Rasterizer-Objekts schreibt. Wenn die Methode fehlschlägt, schreibt sie NULL an diesen Speicherort und gibt einen Fehlercode zurück.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10
Zielplattform	Desktop
Kopfzeile	xpsrassvc.h (include Xpsrassvc.h)

Weitere Informationen

IXpsRasterizationFactory2

Freigeben über