XPS ラスター化サービスの使用

[アーティクル]
03/08/2023

重要

プリンターデバイス開発におけるWindows 10および11での印刷体験をカスタマイズするために、MicrosoftのIPPインボックスクラスドライバーとPrint Support Apps (PSA)の使用を推奨します。

XPS ラスター化サービスは、XPS ドキュメントの固定ページをビットマップに変換する XPS ラスタライザーオブジェクトを実装します。このサービスにより、XPS ドキュメントを一連のビットマップイメージとしてレンダリングする XPSDrv フィルターの設計が簡略化されます。このフィルターでは、XPS ラスタライザーオブジェクトに対して、固定ページ内の軸平行長方形領域のビットマップイメージを作成するように指示できます。

たとえば、プリンターの XPSDrv フィルターでは、固定ページを一連の水平方向または垂直方向のバンドとしてプリンターに送信する必要があります。この場合、フィルターは XPS ラスタライザーオブジェクトに対して、各バンドを個別のビットマップとしてラスタライズするように指示します。または、プリンターに十分なメモリがある場合は、ページ全体のビットマップイメージを作成するようにフィルターがラスタライザーに指示する場合があります。

XPS ラスター化サービスは、システムファイル Xpsrasterservice.dll に実装されます。ただし、XPSDrv フィルターは、この DLL のエントリポイントに直接アクセスしません。代わりに、フィルターは、印刷フィルターパイプラインマネージャーから受け取る 印刷パイプラインプロパティバッグ を介して XPS ラスター化サービスのインターフェイスにアクセスします。

XPSDrv フィルターで使用できるようにするには、印刷フィルターパイプラインのフィルターを記述するフィルターパイプライン構成ファイルで XPS ラスター化サービスを指定する必要があります。具体的には、次の XML 例に示すように、構成ファイルに、サービス DLL 名に dll 属性が設定された FilterServiceProvider 要素が含まれている必要があります。

<FilterServiceProvider dll = "XpsRasterService.dll" />

FilterServiceProvider 要素は、パイプライン内のフィルターを一覧表示する Filters 要素の子です。パイプラインの初期化中、印刷フィルターパイプラインマネージャーは XPS ラスター化サービスを読み込み、プロパティバッグを介してフィルターがサービスにアクセスできるようにします。 XPS ラスター化サービスをロードするフィルターパイプライン構成ファイルの例については、WDK の XpsRasFilter サンプルを参照してください。このサンプルは、WDK インストールの Src\Print\Xpsrasfilter フォルダーにあります。

XPS ラスター化ファクトリの取得

XPS ドキュメントをラスター化する前に、XPSDrv フィルターは、印刷パイプラインプロパティバッグからラスター化ファクトリオブジェクトへの参照を取得する必要があります。その後、フィルターは、レンダリングする必要がある固定ページごとに、ファクトリから新しい XPS ラスタライザーオブジェクトを取得します。

XPSDrv フィルターを初期化するために、印刷フィルターパイプラインマネージャーはフィルターの IPrintPipelineFilter::InitializeFilter メソッドを呼び出し、プロパティバッグの IPrintPipelinePropertyBag インターフェイスを入力パラメーターとしてメソッドに渡します。

XPS ラスター化ファクトリオブジェクトへのポインターを取得するために、XPSDrv フィルターは IPrintPipelinePropertyBag::GetProperty メソッドを呼び出します。プロパティ名 "MS_IXpsRasterizationFactory" は、ラスター化ファクトリオブジェクトを識別します。このプロパティの場合、GetProperty から取得した値は、ラスター化ファクトリオブジェクトの IUnknown インターフェイスへの参照です。このインターフェイスを取得した後、フィルターは IUnknown::QueryInterface メソッドを呼び出し、オブジェクトの IXpsRasterizationFactory インターフェイスへの参照を取得する必要があります。その後、フィルターは IXpsRasterizationFactory::CreateRasterizer メソッドを呼び出して XPS ラスタライザーオブジェクトを作成できます。

ファクトリオブジェクトが不要になったら、フィルターはオブジェクトの IXpsRasterizationFactory インターフェイスの Release メソッドを呼び出してオブジェクトを解放する必要があります。

次のコード例は、IPrintPipelinePropertyBag インターフェイスインスタンスから IXpsRasterizationFactory インターフェイスインスタンスを取得する方法を示しています。

//
// Retrieve a reference to the XPS rasterization factory
// from the print pipeline property bag.
//
HRESULT CreateRasterizationFactory(
 IPrintPipelinePropertyBag *pPropertyBag,
 IXpsRasterizationFactory **ppXPSRasFactory)
{
    if (ppXPSRasFactory != NULL)
    {
        *ppXPSRasFactory = NULL;
    }

    if (pPropertyBag == NULL || ppXPSRasFactory == NULL)
    {
        return E_POINTER;
    }

    HRESULT hr;
    VARIANT var;
 IXpsRasterizationFactory *pXPSRasFactory;

    //
    // Retrieve the factory object from the property bag.
    //
 VariantInit(&var);
    hr = pPropertyBag->GetProperty(L"MS_IXpsRasterizationFactory",
                                   &var);
    if (SUCCEEDED(hr))
    {
        assert(var.vt == VT_UNKNOWN && var.punkVal != NULL);

        //
        // Get the factory object's IXpsRasterizationFactory interface.
        //
 IUnknown *pUnknown = var.punkVal;

        hr = pUnknown->QueryInterface(__uuidof(IXpsRasterizationFactory),
 reinterpret_cast<void**>(&pXPSRasFactory));
    }

    if (SUCCEEDED(hr))
    {
        //
        // Give the caller our reference to the IXpsRasterizationFactory interface.
        //
        *ppXPSRasFactory = pXPSRasFactory;
    }

 VariantClear(&var);
    return hr;
}

固定ページの XPS オブジェクトモデルの作成

XPS ラスター化ファクトリを作成した後、XPSDrv フィルターはファクトリを使用して XPS ラスタライザーオブジェクトを作成できます。 XPS ラスタライザーオブジェクトには IXpsRasterizer インターフェイスがあります。各 XPS ラスタライザーオブジェクトは、XPS ドキュメントの特定の固定ページ専用です。 XPS ラスタライザーオブジェクトを作成するため、ファクトリには固定ページの XPS オブジェクトモデル (OM) が必要です。 (固定ページの) XPS OM は IXpsOMPage インターフェイスを持つオブジェクトに含まれています。 XPS ラスタライザーオブジェクトは、このインターフェイスを使用して固定ページの内容にアクセスします。 IKsControl インターフェイスの詳細については、Windows SDK のドキュメントを参照してください。

XPSDrv フィルターは、次の手順に従って XPS ラスタライザーオブジェクトを作成します。

このフィルターは IFixedPage インターフェイスを持つ固定ページオブジェクトを入力ストリームから読み取ります。
フィルターは、固定ページの内容を保持する IXpsOMPage インターフェイスを持つ XPS OM オブジェクトを作成します。 XPS ラスタライザーは、後でこのインターフェイスを使用して固定ページの内容にアクセスします。
XPS ラスタライザーオブジェクトを作成するために、フィルターは XPS OM オブジェクトの IXpsOMPage インターフェイスを XPS ラスター化ファクトリの IXpsRasterizationFactory::CreateRasterizer メソッドに渡します。

XPS ラスタライザーオブジェクトが不要になったら、フィルターはオブジェクトの IXpsRasterizerRelease インターフェイスの Release メソッドを呼び出してオブジェクトを解放する必要があります。 XPS ラスター化サービスを使用する XPSDrv フィルターの実装例については、WDK の XpsRasFilter サンプルドライバーを参照してください。

XPS ラスター化サービスで使用する場合、固定ページ内のキャンバスとビジュアルブラシを最大 64 レベルまでネストすることができます。キャンバスとビジュアルブラシの詳細については、XML Paper Specification をダウンロードしてください。

ビットマップ解像度とピクセル形式

固定ページの XPS ラスタライザーオブジェクトは、ページがレンダリングされる解像度を認識している必要があります。 XPSDrv フィルターは、XPS ラスタライザーオブジェクトを作成する IXpsRasterizationFactory::CreateRasterizer に対する呼び出しの入力パラメーターとして、この解像度を 1 インチあたりのドット数 (DPI) で指定します。たとえば、ディスプレイデバイスの解像度が 600 DPI で、固定ページに標準の文字サイズのページが記述されている場合、ページ全体のビットマップイメージのサイズは次のようになります。

幅 = (8.5 インチ)x(600 DPI) = 5100 ドット

高さ = (11 インチ)x(600 DPI) = 6600 ドット

固定ページの長方形領域のビットマップイメージを作成するために、XPSDrv フィルターは XPS ラスタライザーオブジェクトの IXpsRasterizer::RasterizeRect メソッドを呼び出します。このメソッドは、常に 32 ビットのピクセルサイズのビットマップを生成します。ピクセル形式は、ヘッダーファイル Wincodec.h で定義されている GUID 値 GUID_WICPixelFormat32bppPBGRA によって指定されます。この形式には、8 ビットの赤、緑、青のコンポーネントが含まれており、標準 (sRGB) 色空間が使用されます。さらに、この形式には 8 ビットのアルファコンポーネントが含まれます。各ピクセル値のカラーコンポーネントは、アルファコンポーネントによって事前乗算されます。この形式の詳細については、「ネイティブピクセル形式の概要」を参照してください。

一部の XPSDrv フィルターは、XPS ラスタライザーオブジェクトによって生成されたビットマップの追加処理を実行する場合があります。たとえば、カラープリンターのフィルターは、プリンターのページ記述言語でビットマップをラップしてプリンターに送信する前に、ビットマップを CMYK ピクセル形式に変換する場合があります。

XPS ラスター化サービスが XPSDrv フィルターとの通信に使用するインターフェイスの詳細については、xpsrassvc.h ヘッダー DDI リファレンスを参照してください。

XPSRas と高精度ピクセル形式

Windows 8 で、XPS ラスター化サービスは、新しいバージョンの IXpsRasterizationFactory である新しいインターフェイスの IXpsRasterizationFactory1 を公開します。 IXpsRasterizationFactory1 では、Windows 7 バージョン (IXpsRasterizationFactory::CreateRasterizer) と同じ新しいメソッド IXpsRasterizationFactory1::CreateRasterizer が公開されます。ただし、出力ピクセル形式の新しいパラメーターを 1 つ受け取ります。
この機能では、新しいリストの XPSRAS_PIXEL_FORMAT を公開します。これにより、呼び出元は IXpsRasterizer::RasterizeRect メソッドによって返されるIWICBitmap インターフェイスで使用されるピクセル形式を選択できます。

XPSRas と GPU

WDDM 1.2 ディスプレイドライバーを搭載した Windows 8 を実行しているコンピューターがあり、XPSRas GPU 使用率デシジョンツリーに示されているすべての条件が満たされている場合は、GPU ハードウェアアクセラレーションが常に使用されます。つまり、開発者は、GPU によって提供されるパフォーマンスの強化の恩恵を受けるために手順を実行する必要はありません。ただし、システムのグラフィックスパフォーマンスをさらに最適化するには、次の操作を検討する必要があります。

一貫性のある四角形ディメンションを持つ RasterizeRect メソッドを呼び出します。これが不可能な場合は、最初の呼び出しで必要な最大の四角形サイズを RasterizeRect に提供し、後続の呼び出しで小さい四角形サイズを要求するのが最適です。
アンチエイリアシングは、絶対に必要な場合にのみ使用してください。エイリアス化されたテキストとベクターは、IXpsRasterizationFactory::CreateRasterizer メソッドに提供される DPI 値が大幅に高い場合、アンチエイリアス化された対応部分と同じように見えます。たとえば、200DPI を超える DPI 値は高いと見なされます。エイリアス化されたテキストとベクターを高 DPI と共に使用する場合は、特定のデバイスの出力品質が十分であることを確認するために、テストを行う必要があります。
IXpsOMPage をラスター化する前にドキュメントを操作できる場合は、フォントをサブセット化し、複数のページで繰り返される要素にリソースディクショナリを使用すると、XPSRas のパフォーマンスが向上します。

次の方法で共有

XPS ラスター化サービスの使用

XPS ラスター化ファクトリの取得

固定ページの XPS オブジェクトモデルの作成

ビットマップ解像度とピクセル形式

XPSRas と高精度ピクセル形式

XPSRas と GPU

フィードバック

フィードバック

その他のリソース

次の方法で共有

XPS ラスター化サービスの使用

XPS ラスター化ファクトリの取得

固定ページの XPS オブジェクト モデルの作成

ビットマップ解像度とピクセル形式

XPSRas と高精度ピクセル形式

XPSRas と GPU

フィードバック

フィードバック

その他のリソース

固定ページの XPS オブジェクトモデルの作成