ハッチパターンの操作 | Python

PSドキュメントにハッチパターンを追加する

ハッチパターンは、多くの場合、シンプルな白黒画像に様々なハッチデザインを施したもので、テクスチャのタイリングパターンとして機能します。.NET経由のAspose.Page for Pythonでは、これらのパターンはaspose.pydrawing.Brushから派生したaspose.pydrawing.drawing2d.HatchBrushクラスで表現されます。aspose.pydrawing.TextureBrushとは異なり、HatchBrushはタイリングに使用する画像を定義する、名前付きの定義済みスタイルを提供します。Aspose.Page for Pythonは53種類のハッチスタイルを提供しており、これらはすべてPsDocumentでの塗りつぶしやストロークに利用できます。

グラフィックオブジェクトをハッチパターンで描画するには、目的のハッチスタイルを持つHatchBrushを作成し、set_paint()、またはaspose.pydrawing.Brushを受け入れる**fill_text()メソッドやfill_and_stroke_text()**メソッドのいずれかに渡します。

グラフィック オブジェクトをハッチ パターンでアウトラインするには、 PsDocument でハッチ パターンを現在のペイントとして設定し、新しい aspose.pydrawing.Pen を作成して、set_stroke() または aspose.pydrawing.Pen を受け入れる outline_text() メソッドや fill_and_stroke_text() メソッドのいずれかに渡します。

以下の例では、ハッチ パターンで図形を塗りつぶす方法、Python でのさまざまなハッチ スタイルの使用方法、ハッチ パターンでテキストを塗りつぶしてアウトラインする方法を示します。

新しいPSドキュメントでグラフィックオブジェクトをハッチパターンでペイントするアルゴリズムは次のとおりです。

1. 生成されるPSファイル用の出力ストリームを作成します。
2. PsSaveOptions を初期化します。
3. 既に作成済みの出力ストリームと保存オプションを使用して、 PsDocument を作成します。
4. 塗りつぶしまたはアウトライン化するオブジェクトに応じて、図形またはフォントを作成します。
5. 目的のスタイルで aspose.pydrawing.drawing2d.HatchBrush オブジェクトを作成します。
6. PsDocument で、ハッチペイントを現在のペイントとして設定します。
7. 現在のペイントで図形を塗りつぶすか、テキストを塗りつぶします。 aspose.pydrawing.Brush をパラメーターとして受け入れるテキスト入力メソッドのいずれかを使用する場合は、前の手順をスキップできます。
8. ページを閉じます。
9. ドキュメントを保存します。

グラフィックオブジェクトにハッチパターンの*ストローク（アウトライン）*が必要な場合は、最後の4つの手順は次のように変更します。

6. PsDocument でハッチペイントを現在のペイントとして設定します。
7. aspose.pydrawing.Pen オブジェクトを作成します。
8. このストロークを PsDocument で現在のストロークとして設定します。
9. 現在のペイントとストロークで図形のアウトラインを作成するか、テキストのアウトラインを作成します。aspose.pydrawing.Pen をパラメーターとして受け入れるテキストのアウトライン化メソッドのいずれかを使用する場合は、前の手順は省略できます。
10. ページを閉じます。
11. ドキュメントを保存します。

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

# Create an output stream for the PostScript document
with open(data_dir + "AddHatchPattern_outPS.ps", "wb") as out_ps_stream:
    # Create the save options with A4 size
    options = PsSaveOptions()
    
    # Create a new 1-paged PS Document
    document = PsDocument(out_ps_stream, options, False)
    
    x0 = 20.
    y0 = 100.
    square_side = 32.
    width = 500.
    sum_x = 0.
    
    # Restore a graphics state
    document.write_graphics_save()
    
    # Translate to initial point
    document.translate(x0, y0)
    
    # Create a rectngle path for every pattern square
    path = aspose.pydrawing.drawing2d.GraphicsPath()
    path.add_rectangle(aspose.pydrawing.RectangleF(0, 0, square_side, square_side))
    
    # Create a pen for outlining the pattern square
    pen = GraphicsFactory.create_pen_by_color_and_width(aspose.pydrawing.Color.black, 2)
    
    # For every hatch pattern style 
    hatch_style = 0
    while hatch_style <= 52:
        # Set the paint with the current hatch brush style
        document.set_paint(aspose.pydrawing.drawing2d.HatchBrush(aspose.pydrawing.drawing2d.HatchStyle(hatch_style),
            aspose.pydrawing.Color.black, aspose.pydrawing.Color.white))
        
        # Calculate the displacement not to go beyond the page bounds
        x = square_side
        y = 0
        if sum_x >= width:
            x = -(sum_x - square_side)
            y += square_side
        # Translate the current graphics state
        document.translate(x, y)
        # Fill the pattern square
        document.fill(path)
        # Set the stroke
        document.set_stroke(pen)
        # Draw the square outline
        document.draw(path)
        
        # Calculate the distance from X0
        if sum_x >= width:
            sum_x = square_side
        else:
            sum_x += x
        hatch_style += 1
    
    # Restore the graphics state
    document.write_graphics_restore()
    
    # Fill the text with the hatch pattern
    brush = aspose.pydrawing.drawing2d.HatchBrush(aspose.pydrawing.drawing2d.HatchStyle.DIAGONAL_CROSS,
    aspose.pydrawing.Color.red, aspose.pydrawing.Color.yellow)
    font = ExternalFontCache.fetch_dr_font("Arial", 96, aspose.pydrawing.FontStyle.BOLD)
    document.fill_and_stroke_text("ABC", font, 200, 300, brush, pen)
    
    # Outline text with the hatch pattern
    brush = aspose.pydrawing.drawing2d.HatchBrush(aspose.pydrawing.drawing2d.HatchStyle.PERCENT50,
    aspose.pydrawing.Color.blue, aspose.pydrawing.Color.white)
    document.outline_text("ABC", font, 200, 400, GraphicsFactory.create_pen_by_brush_and_width(brush, 5))
    
    
    # Close the current page
    document.close_page()
    
    # Save the document
    document.save()

PS ドキュメント内のハッチ パターンの操作については、 .NET、 Java を参照してください。

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

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