IXpsRasterizationFactory2::CreateRasterizer メソッド (xpsrassvc.h)

  • [アーティクル]

CreateRasterizer メソッドは、XPS ラスター化サービスを使用して XPS から PWG ラスターにコンテンツを変換できる XPS ラスタライザー オブジェクトを作成します。 PWG ラスターは非正方形の DPI をサポートします。

構文

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

パラメーター

[in, optional] xpsPage

レンダリングする XPS 固定ページを表す IXpsOMPage オブジェクトへのポインター。 このオブジェクトは、XPS ドキュメントから FixedPage セクションをカプセル化します。

[in] DPIX

ラスター化された出力ビットマップの x 次元に適用される 1 インチあたりのドット数。 DPI 値は、XPS 固定ページを印刷または表示するデバイスの解像度です。

[in] DPIY

ラスター化された出力ビットマップの y 次元に適用される 1 インチあたりのドット数。

[in] nonTextRenderingMode

ラスター化された出力内のテキスト以外のアイテムのレンダリング モード。 このパラメーターは、アンチエイリアス出力を生成するかどうかを示します。 このパラメーターを、次のいずれかのXPSRAS_RENDERING_MODE列挙値 に 設定します。

  • XPSRAS_RENDERING_MODE_ANTIALIASED

  • XPSRAS_RENDERING_MODE_ALIASED

[in] textRenderingMode

ラスター化された出力内のテキストのレンダリング モード。 このパラメーターは、アンチエイリアス出力を生成するかどうかを示します。 このパラメーターを、次のいずれかのXPSRAS_RENDERING_MODE列挙値に設定します。

  • XPSRAS_RENDERING_MODE_ANTIALIASED

  • XPSRAS_RENDERING_MODE_ALIASED

[in] pixelFormat

呼び出し元が IXpsRasterizer::RasterizeRect によって返される IWICBitmap で使用されるピクセル形式を選択できるようにします。 このパラメーターを、次のいずれかの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

呼び出し元が背景色を選択できるようにします。 このパラメーターを、次のいずれかのXPSRAS_BACKGROUND_COLOR列挙値 に 設定します。

  • XPSRAS_BACKGROUND_COLOR_TRANSPARENT

  • XPSRAS_BACKGROUND_COLOR_OPAQUE

  • 既定の背景色はXPSRAS_BACKGROUND_COLOR_TRANSPARENTです。

[out, optional] ppIXpsRasterizer

このパラメーターは、新しく作成された XPS ラスタライザー オブジェクトの IXpsRasterizer インターフェイスへのポインターをメソッドが書き込む場所を指します。 メソッドが失敗した場合、この場所に NULL を 書き込み、エラー コードを返します。

戻り値

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

要件

要件 値
サポートされている最小のクライアント Windows 10
対象プラットフォーム デスクトップ
Header xpsrassvc.h (Xpsrassvc.h を含む)

こちらもご覧ください

IXpsRasterizationFactory2