PSファイル内のクリップの操作 | Java

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

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

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

• 任意の閉じた図形を含むことができるjava.awt.Shapeを実装した任意のクラスを使用する。
• テキストのアウトラインを使用する。
• 1bpp（ピクセルあたりのビット数）の2色画像をステンシルマスクとして使用する。

現在、Aspose.Page for Javaライブラリは、1番目と2番目のクリッピング方法を提供しています。 以下の例では、円形をクリッピングパスとして取得し、同じグラフィック状態にある青色で塗りつぶされた四角形を切り取ります。

この例では、Aspose.Page for Java ライブラリを使用して新しい PsDocument にクリップを追加します。

1. 生成される PS ファイルの出力ストリームを作成します。
2. デフォルトのオプションで PsSaveOptions オブジェクトを作成します。
3. 既に作成済みの出力ストリームと保存オプションを使用して、1 ページの PsDocument を作成します。
4. 新しいグラフィックス状態を作成します。
5. 円 (java.awt.geom.Ellipse2D オブジェクト) の図形を作成します。
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(getOutputDir() + outputFileName, options, false);

//Create graphics path from the rectangle
GeneralPath rectanglePath = new GeneralPath();
rectanglePath.append(new Rectangle2D.Float(0, 0, 300, 200), false);

////////////////////////////////////// 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
GeneralPath circlePath = new GeneralPath();
circlePath.append(new Ellipse2D.Float(50, 0, 200, 200), false);

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

//Set paint in the current graphics state
document.setPaint(Color.BLUE);

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

//Restore graphics state to the previous (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);

//Create dashed stroke similar to Pen with DashStyle.Dash
float[] dash = new float[] { 5.0f };
BasicStroke stroke = new BasicStroke(2.0f, BasicStroke.CAP_BUTT, BasicStroke.JOIN_MITER, 10.0f, dash, 0.0f);

document.setStroke(stroke);

//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();

See working with clips in PS documents in .NET.

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

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

この例では、Aspose.Page for Java ライブラリを使用して、新しい 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(getOutputDir() + outputFileName, options, false);

//Create graphics path from the rectangle
GeneralPath rectanglePath = new GeneralPath();
rectanglePath.append(new Rectangle2D.Float(0, 0, 300, 200), false);

//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);

float[] dash = new float[] { 5.0f };
BasicStroke stroke = new BasicStroke(2.0f, BasicStroke.CAP_BUTT, BasicStroke.JOIN_MITER, 10.0f, dash, 0.0f);

int fontSize = 120;
Font font = new Font("Arial", Font.BOLD, fontSize);

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

//Set paint in the current graphics state
document.setPaint(Color.BLUE);

document.fill(rectanglePath);

document.writeGraphicsRestore();

document.translate(100, 100);

//Set paint in the current graphics state
document.setPaint(Color.BLUE);

document.setStroke(stroke);
//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();

PSドキュメント内のクリップの操作については、 .NET.

このコードを実行すると、次のような結果が表示されます。

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