Working with Textures in PS file | Python

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

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

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

Aspose.Page for Python via .NETライブラリは、Pythonプラットフォームで提供されるaspose.pydrawing.Brushによって実装されたすべての重要なクラスを処理します。これらは、aspose.pydrawing.Color、aspose.pydrawing.TextureBrush、 aspose.pydrawing.drawing2d.LinearGradientBrush、および aspose.pydrawing.drawing2d.PathGradientBrush です。Python のストロークの色は、aspose.pydrawing.Pen オブジェクトのストロークのプロパティとは別に割り当てられ、aspose.pydrawing.Brush を再度使用します。 したがって、.NET ライブラリを介して Aspose.Page for Python は、線の描画、図形やテキストのアウトライン化にペイントの実装の完全なセットを使用できます。

Aspose.Page for Python で .NET ライブラリを使用してグラフィック オブジェクトにテクスチャ パターンを ペイント するには、set_paint() または、aspose.pydrawing.Brush をパラメーターとして受け取る fill_text() や fill_and_stroke_text() メソッドのいずれかに aspose.pydrawing.TextureBrush を渡すだけで十分です。

グラフィック オブジェクトにテクスチャ パターンを アウトライン するには、set_paint() または、ストローク ペイントをパラメーターとして受け取る outline_text() や fill_and_stroke_text() メソッドのいずれかに aspose.pydrawing.TextureBrush オブジェクトを渡す必要があります。

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

テクスチャパターンと PsDocument の操作手順を以下に説明します。

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

# The path to the documents directory.
data_dir = Util.get_data_dir_working_with_textures()

# Create an output stream for the PostScript document
with open(data_dir + "AddTextureTilingPattern_outPS.ps", "wb") as out_ps_stream:
    # Create the save options with the A4 size
    options = PsSaveOptions()
    
    # Create a new 1-paged PS Document
    document = PsDocument(out_ps_stream, options, False)
    
    
    document.write_graphics_save()
    document.translate(200, 100)
    
    #Create a Bitmap object from an image file
    with aspose.pydrawing.Bitmap(data_dir + "TestTexture.bmp") as image:
        # Create a texture brush from the image
        brush = aspose.pydrawing.TextureBrush(image, aspose.pydrawing.drawing2d.WrapMode.TILE)
        
        # Add scaling in the X direction to the mattern
        transform = aspose.pydrawing.drawing2d.Matrix(float(2), float(0), float(0), float(1), float(0), float(0))
        brush.transform = transform
        
        # Set this texture brush as a current paint
        document.set_paint(brush)
    
    # Create a rectangle path
    path = aspose.pydrawing.drawing2d.GraphicsPath()
    path.add_rectangle(aspose.pydrawing.RectangleF(0, 0, 200, 100))
    
    # Fill the rectangle
    document.fill(path)
    
    # Get the current paint
    paint = document.get_paint()
    
    # Set a red stroke
    pen1 = aspose.pydrawing.Pen(aspose.pydrawing.Color.red)
    pen1.width = float(2)
    document.set_stroke(pen1)

    # Stroke the rectangle
    document.draw(path)
    
    document.write_graphics_restore()
    
    # Fill the text with the texture pattern                
    font = aspose.page.ExternalFontCache.create_font_by_family_name("Arial", 96, aspose.pydrawing.FontStyle.BOLD)
    pen2 = aspose.pydrawing.Pen(aspose.pydrawing.Color.black)
    pen2.width = float(2)
    document.fill_and_stroke_text("ABC", font, 200, 300, paint, pen2)
    
    # Outline the text with the texture pattern
    pen3 = aspose.pydrawing.Pen(aspose.pydrawing.Color.black)
    pen3.brush = paint
    pen3.width = float(5)
    document.outline_text("ABC", font, 200, 400, pen3)
    
    # Close the current page
    document.close_page()
    
    # Save the document
    document.save()

PS ドキュメント内のテクスチャの操作については、 .NET、 Java を参照してください。

このコードを実行した結果は

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