PostScript でのテクスチャ操作 | .NET

PSドキュメントにテクスチャタイリングパターンを追加する

テクスチャタイリングパターンは、図形やテキストなどのオブジェクトの塗りつぶしや描画に使用される画像です。画像のサイズがオブジェクトのサイズより小さい場合は、必要な領域をすべて覆うためにX方向とY方向に画像が繰り返されます。

グラフィックオブジェクト内で画像を繰り返す処理はタイリングと呼ばれます。 PsDocumentでペイントやストロークを設定するには、ペイントの場合はSystem.Drawing.Brushクラスのオブジェクト、ストロークの場合はSystem.Drawing.Penクラスのオブジェクトをそれぞれのメソッドに渡す必要があります。

Aspose.Page for .NET ライブラリは、.NET プラットフォームで提供される System.Drawing.Brush のすべてのサブクラスを処理します。これらのサブクラスは、System.Drawing.SolidBrush、System.Drawing.TextureBrush、System.Drawing.LinearGradientBrush、System.Drawing.PathGradientBrush、および System.Drawing.HatchBrush です。System.Drawing.Pen クラスはシールされているため拡張できませんが、System.Drawing.Brush をプロパティとして含んでいるため、Aspose.Page for .NET ライブラリでは、直線の描画や図形およびテキストのアウトラインにも使用できる完全なブラシ セットを使用できます。

Aspose.Page for .NET ライブラリでグラフィック オブジェクトをテクスチャ パターンで 描画 するには、System.Drawing.TextureBrush を SetPaint() または FillText() や FillAndStrokeText() メソッド (いずれも System.Drawing.Brush をパラメーターとして受け取ります) に渡すだけです。

Aspose.Page for .NET ライブラリでグラフィック オブジェクトをテクスチャ パターンで アウトライン するには、System.Drawing.TextureBrush を含む新しい System.Drawing.Pen を作成し、それを SetStroke() または OutlineText() や FillAndStrokeText() メソッド (いずれも System.Drawing.Pen をパラメーターとして受け取ります) に渡す必要があります。

以下の例では、テクスチャ タイリング パターンを使用して図形とテキストを塗りつぶし、テキストのアウトラインを描く方法を示します。

例におけるテクスチャパターンと PsDocument の操作手順の説明:

1. 生成される PS ファイルの出力ストリームを作成します。
2. デフォルトのオプションで PsSaveOptions オブジェクトを作成します。
3. 既に作成済みの出力ストリームと保存オプションを使用して、1 ページの PsDocument を作成します。
4. 新しいグラフィックス状態を作成し、必要な位置に移動します。
5. 画像ファイルから System.Drawing.Bitmap を作成します。
6. 画像から System.Drawing.TextureBrush を作成します。
7. テクスチャブラシに必要な変換を設定します。
8. PsDocument の現在のグラフィックス状態で、テクスチャブラシを現在のペイントとして設定します。
9. 長方形のパスを作成します。
10. テクスチャブラシで長方形を塗りつぶします。
11. 現在のペイントを将来使用するためにローカル変数に保存します。
12. 赤いペンで現在のストロークを設定します。
13. 現在のペンで長方形のアウトラインを描画します。
14. 現在のグラフィック状態から上位レベルのグラフィック状態に移行します。
15. システム フォントを作成します。
16. テキストを塗りつぶし、ストローク（アウトライン）します。塗りつぶしにはテクスチャブラシを使用し、ストロークには黒のペンを使用します。
17. テクスチャブラシをブラシとして作成した新しい System.Drawing.Pen を使用して、他の位置のテキストのアウトラインを描画します。
18. ページを閉じます。
19. ドキュメントを保存します。

 //Create an output stream for PostScript document
using (Stream outPsStream = new FileStream(dataDir + "AddTextureTilingPattern_outPS.ps", FileMode.Create))
{
    //Create save options with A4 size
    PsSaveOptions options = new PsSaveOptions();

    // Create new 1-paged PS Document
    PsDocument document = new PsDocument(outPsStream, options, false);

    
    document.WriteGraphicsSave();
    document.Translate(200, 100);

    //Create a Bitmap object from image file
    using (Bitmap image = new Bitmap(dataDir + "TestTexture.bmp"))
    {
        //Create texture brush from the image
        TextureBrush brush = new TextureBrush(image, WrapMode.Tile);

        //Add scaling in X direction to the mattern
        Matrix transform = new Matrix(2, 0, 0, 1, 0, 0);
        brush.Transform = transform;

        //Set this texture brush as current paint
        document.SetPaint(brush);
    }

    //Create a rectangle path
    GraphicsPath path = new GraphicsPath();
    path.AddRectangle(new RectangleF(0, 0, 200, 100));

    //Fill the rectangle
    document.Fill(path);

    //Get current paint
    Brush paint = document.GetPaint();

    //Set red stroke
    document.SetStroke(new Pen(new SolidBrush(Color.Red), 2));
    //Stroke the rectangle
    document.Draw(path);

    document.WriteGraphicsRestore();

    //Fill the text with the texture pattern                
    Font font = new Font("Arial", 96, FontStyle.Bold);
    document.FillAndStrokeText("ABC", font, 200, 300, paint, new Pen(Color.Black, 2));

    //Outline the text with the texture pattern
    document.OutlineText("ABC", font, 200, 400, new Pen(paint, 5));

    //Close current page
    document.ClosePage();

    //Save the document
    document.Save();
}

Linux、macOS、その他のWindows以外のオペレーティングシステムでは、 Aspose.Page.Drawing NuGetパッケージをご利用いただけます。このパッケージは、System.Drawingシステムライブラリではなく、Aspose.Drawingバックエンドを使用します。

そのため、System.Drawing名前空間ではなく、Aspose.Page.Drawing名前空間をインポートしてください。上記のコードスニペットでは、System.Drawing.RectangleFではなくAspose.Page.Drawing.RectangleFが、System.Drawing.Drawing2D.GraphicsPathではなくAspose.Page.Drawing.Drawing2D.GraphicsPathが使用されるなど、必要な置換はすべてGitHubのコード例に記載されています。

Java の PS ドキュメントでのテクスチャの操作を参照してください。

このコードを実行した結果は次のように表示されます。

サンプルとデータ ファイルは GitHub からダウンロードできます。