PostScript でのクリップ操作 | .NET

PS ドキュメントにクリップを追加

PS ドキュメント内のクリップとは、PS ビューアーまたはエディターに表示される現在のグラフィック ステートのコンテンツを囲むパスです。境界からはみ出したコンテンツは切り取られます。

.NET では、クリッピング パスは 3 つの方法で割り当てることができます。

• 任意の閉じた図形を含む System.Drawing.Drawing2D.GraphicsPath を使用する。
• テキストのアウトラインを使用する。
• 1 bpp (ビット/ピクセル) の 2 色画像をステンシル マスクとして使用する。

現在、Aspose.Page for .NET ライブラリでは、1 番目と 2 番目のクリッピング方法を提供しています。以下の例では、四角形から円 System.Drawing.Drawing2D.GraphicsPath をクリッピング パスとして取得し、同じグラフィック ステートで青色に塗りつぶされた四角形を切り取っています。

この例では、Aspose.Page for .NET ライブラリを使用して新しい PsDocument にクリップを追加するために、次の手順を実行します。

1. 結果の PS ファイルの出力ストリームを作成します。
2. デフォルトのオプションで PsSaveOptions オブジェクトを作成します。
3. 既に作成済みの出力ストリームと保存オプションを使用して、1 ページの PsDocument を作成します。
4. 新しいグラフィックス状態を作成します。
5. 四角形から円 System.Drawing.Drawing2D.GraphicsPath を作成します。
6. このパスにクリップを設定します。
7. PsDocument の現在のグラフィックス状態にペイントを設定します。
8. 現在のペイントで四角形のパスを塗りつぶします。
9. 現在のグラフィック状態から上位レベルへ移動します。
10. 塗りつぶされた四角形の位置に移動します。
11. 塗りつぶされた四角形の上にある同じ四角形の境界を破線で囲み、切り取られた塗りつぶされた四角形の境界を表示します。
12. ページを閉じます。
13. ドキュメントを保存します。

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

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

    //Create a graphics path from the rectangle
    GraphicsPath rectangePath = new GraphicsPath();
    rectangePath.AddRectangle(new RectangleF(0, 0, 300, 200));

    //Save the graphics state in order to return back to this state after transformation
    document.WriteGraphicsSave();

    //Displace the current graphics state on 100 points to the right and 100 points to the bottom.
    document.Translate(100, 100);

    //Create a graphics path from the circle
    GraphicsPath circlePath = new GraphicsPath();
    circlePath.AddEllipse(new RectangleF(50, 0, 200, 200));

    //Add a clipping by the circle to the current graphics state
    document.Clip(circlePath);

    //Set the paint in the current graphics state
    document.SetPaint(new SolidBrush(Color.Blue));

    //Fill the rectangle in the current graphics state (with the clipping)
    document.Fill(rectangePath);

    //Restore the graphics state to the previus (upper) level
    document.WriteGraphicsRestore();

    //Displace the upper level graphics state on 100 points to the right and 100 points to the bottom.
    document.Translate(100, 100);

    Pen pen = new Pen(new SolidBrush(Color.Blue), 2);
    pen.DashStyle = DashStyle.Dash;

    document.SetStroke(pen);

    //Draw the rectangle in the current graphics state (has no clipping) above the clipped rectngle
    document.Draw(rectangePath);

    //Close the current page
    document.ClosePage();

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

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

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

Java の PS ドキュメント内のクリップの操作を参照してください。

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

次の例では、テキストのアウトラインで青く塗りつぶされた四角形をクリッピングするフォントを取得します。

この例では、Aspose.Page for .NET ライブラリを使用して、新しい PsDocument にテキストによるクリッピングを追加するために、以下の手順を実行します。

1. 生成された PS ファイルの出力ストリームを作成します。
2. デフォルトのオプションで PsSaveOptions オブジェクトを作成します。
3. 既に作成済みの出力ストリームと保存オプションを使用して、1 ページの PsDocument を作成します。
4. 新しいグラフィックス状態を作成します。
5. フォントを作成します。
6. テキストとフォントでクリップを設定します。
7. PsDocument の現在のグラフィック状態にペイントを設定します。
8. 現在のペイントで四角形のパスを塗りつぶします。
9. 現在のグラフィック状態から上位レベルへ移動します。
10. 塗りつぶされた四角形の位置に移動します。
11. 塗りつぶされた四角形の上にある同じ四角形の境界を破線で囲み、切り取られた塗りつぶされた四角形の境界を示します。
12. ページを閉じます。
13. ドキュメントを保存します。

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

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

    //Create a graphics path from the rectangle
    GraphicsPath rectangePath = new GraphicsPath();
    rectangePath.AddRectangle(new RectangleF(0, 0, 300, 200));

    //Save the graphics state in order to return back to this state after transformation
    document.WriteGraphicsSave();

    //Displace the current graphics state on 100 points to the right and 100 points to the bottom.
    document.Translate(100, 100);
    
    //Set the paint in the current graphics state
    document.SetPaint(new SolidBrush(Color.Blue));

    //Create a font
    int fontSize = 120;
    Font font = new Font("Arial", fontSize, FontStyle.Bold);

    //Clip the rectangle by text's outline
    document.ClipText("ABC", font, 20, fontSize + 10);
    document.Fill(rectanglePath);

    //Restore the graphics state to the previus (upper) level
    document.WriteGraphicsRestore();

		//Displace the upper level graphics state on 100 points to the right and 100 points to the bottom.
    document.Translate(100, 100);

		Pen pen = new Pen(new SolidBrush(Color.Blue), 2);
    pen.DashStyle = DashStyle.Dash;

    document.SetStroke(pen);
    
    //Draw the rectangle in the current graphics state (has no clipping) above the clipped rectangle
    document.Draw(rectanglePath);

    //Close the current page
    document.ClosePage();

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

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

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

Java の PS ドキュメント内のクリップの操作方法をご覧ください。

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

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