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. ドキュメントを保存します。

// Demonstrates clipping by shape and clipping by text in PS document.

string outputFileName = "ApplyClipByShape_outPS.ps";

//Create save options with A4 size
PsSaveOptions options = new PsSaveOptions();

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

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

////////////////////////////////////// Clipping by shape //////////////////////////////////////////////////////////////////////

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

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

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

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

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

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

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

//Displace 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 clipped rectangle
document.Draw(rectanglePath);

//Close 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. ドキュメントを保存します。

// Demonstrates clipping by text in PS document.

string outputFileName = "ApplyClipByText_outPS.ps";

//Create save options with A4 size
PsSaveOptions options = new PsSaveOptions();

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

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

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

//Displace current 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;
int fontSize = 120;
System.Drawing.Font font = new System.Drawing.Font("Arial", fontSize, FontStyle.Bold);

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

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

document.Fill(rectanglePath);

document.WriteGraphicsRestore();

document.Translate(100, 100);

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

//Close 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 からダウンロードできます。