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 を含む) |