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

Article
03/01/2024

La méthode CreateRasterizer crée un objet rastériseur XPS qui peut convertir du contenu de XPS en raster PWG à l’aide du service de rastérisation XPS. PWG Raster prend en charge les DPI non carrés.

Syntaxe

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

Paramètres

[in, optional] xpsPage

Pointeur vers un objet IXpsOMPage qui représente la page fixe XPS à afficher. Cet objet encapsule une section FixedPage à partir d’un document XPS.

[in] DPIX

Points par pouce appliqués à la dimension x de l’image bitmap de sortie rastérisée. La valeur DPI est la résolution de l’appareil qui doit imprimer ou afficher la page fixe XPS.

[in] DPIY

Points par pouce appliqués à la dimension y de l’image bitmap de sortie rastérisée.

[in] nonTextRenderingMode

Mode de rendu pour les éléments non texte dans la sortie rastérisée. Ce paramètre indique s’il faut générer une sortie anti-ataliased. Définissez ce paramètre sur l’une des valeurs d’énumération XPSRAS_RENDERING_MODE suivantes :

XPSRAS_RENDERING_MODE_ANTIALIASED
XPSRAS_RENDERING_MODE_ALIASED

[in] textRenderingMode

Mode de rendu du texte dans la sortie rastérisée. Ce paramètre indique s’il faut générer une sortie anti-ataliased. Définissez ce paramètre sur l’une des valeurs d’énumération XPSRAS_RENDERING_MODE suivantes :

XPSRAS_RENDERING_MODE_ANTIALIASED
XPSRAS_RENDERING_MODE_ALIASED

[in] pixelFormat

Permet à un appelant de sélectionner le format de pixel utilisé par le IWICBitmap retourné par IXpsRasterizer ::RasterizeRect. Définissez ce paramètre sur l’une des valeurs d’énumération XPSRAS_PIXEL_FORMAT suivantes :

XPSRAS_PIXEL_FORMAT_32BPP_PBGRA_UINT_SRGB
XPSRAS_PIXEL_FORMAT_64BPP_PRGBA_HALF_SCRGB
XPSRAS_PIXEL_FORMAT_128BPP_PRGBA_FLOAT_SCRGB

[in] backgroundColor

Permet à un appelant de sélectionner une couleur d’arrière-plan. Définissez ce paramètre sur l’une des valeurs d’énumération XPSRAS_BACKGROUND_COLOR suivantes :

XPSRAS_BACKGROUND_COLOR_TRANSPARENT
XPSRAS_BACKGROUND_COLOR_OPAQUE
La couleur d’arrière-plan par défaut est XPSRAS_BACKGROUND_COLOR_TRANSPARENT.

[out, optional] ppIXpsRasterizer

Ce paramètre pointe vers un emplacement dans lequel la méthode écrit un pointeur vers l’interface IXpsRasterizer de l’objet rastériseur XPS nouvellement créé. Si la méthode échoue, elle écrit NULL à cet emplacement et retourne un code d’erreur.

Valeur retournée

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 10
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	xpsrassvc.h (inclure Xpsrassvc.h)

Voir aussi

IXpsRasterizationFactory2

Partager via