PSファイルでの変換操作 | Java

PS Document 内のコンテンツを変換する

この記事では、PsDocument に追加された長方形パスに対して、移動、拡大縮小、回転、傾斜といった様々な変換を行う方法について説明します。

1つのコードスニペットを複数のコードに分割し、開始、終了、そして各変換を個別に処理します。PostScript における変換は、常に “gsave” 演算子と “grestore” 演算子によってバインドされたグラフィック状態で行われます。そのため、PsDocument には “writeGraphicsSave()” と “writeGraphicsRestore()” というメソッドがあります。 これらのメソッド間で、ネストされたグラフィック状態を含む任意のコンテンツを追加し、変換やクリッピングを行うことができます。これらの変換は、外側のグラフィック状態には影響しませんが、ネストされたグラフィック状態には影響します。

“writeGraphicsSave()” メソッドと “writeGraphicsRestore()” メソッドを使用せずに変換を行うと、上位レベルのグラフィックス状態で変換が行われ、PsDocument 内のすべてのコンテンツがこの変換の対象となります。

ドキュメントのコンテンツに対して最初から変換を設定するアルゴリズムは、以下の手順で構成されます。

1. 結果のPSファイル用の出力ストリームを作成します。
2. PsSaveOptions を作成します。
3. 既に作成した出力ストリームと保存オプションを使用して、 PsDocument を作成します。
4. グラフィックス状態を保存します。新しいグラフィックス状態を作成し、以前のグラフィックス状態をグラフィックス状態スタックに格納します。
5. 必要な変換を追加します。移動、拡大縮小、回転、傾斜、またはこれらの組み合わせです。コードでは、各変換コンポーネントの影響を個別に表示し、最後に一度に3つずつ表示します。
6. 変換に必要なコンテンツを追加します。今回のケースでは、java.awt.geom.Rectangle2D を作成し、それを塗りつぶしました。変換前に1つの四角形を作成し、現在のグラフィックス状態における各変換後にその四角形を塗りつぶします。
7. グラフィックス状態を復元して、適用された変換の影響を受けない前の状態に戻します。この例では、上位レベルのグラフィックス状態です。

このコードでは、出力ストリームと PsSaveOptions から PsDocument を作成し、上位レベルのグラフィックス状態をポイント 100,100 に変換して最初の四角形をオフセットし、最後に最初の四角形を作成します。

//Create an output stream for PostScript document
FileOutputStream outPsStream = new FileOutputStream(dataDir + "Tranformations_outPS.ps");
//Create a save options with A4 size
PsSaveOptions options = new PsSaveOptions();

// Create new PS Document with the page opened
PsDocument document = new PsDocument(outPsStream, options, false);

document.translate(100, 100);

//Create a rectangle
Shape shape = new Rectangle2D.Float(0, 0, 150, 100);

ここでは、上位レベルのグラフィックス状態の現在のペイント色としてオレンジを設定し、この四角形を塗りつぶします。

結果として得られるPSファイルは、上位レベルのグラフィックス状態にあり、変換されていない最初の図形を示します。

////////////////////////////////////// No transformations ///////////////////////////////////////////////////////////////
//Set paint in graphics state on upper level
document.setPaint(Color.ORANGE);

//Fill the first rectangle that is on on upper level graphics state and that is without any transformations.
document.fill(shape);
/////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////

ここで、上位レベルのグラフィックス状態を基準にX軸で250ポイント移動する新しいグラフィックス状態を作成し、この新しいグラフィックス状態に青で塗りつぶされた同じ四角形を追加します。最後に、上位レベルのグラフィックス状態にある現在のグラフィックス状態から抜け出します。

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

//Displace current graphics state on 250 to the right. So we add translation component to the current transformation.
document.translate(250, 0);

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

//Fill the second rectangle in the current graphics state (has translation transformation)
document.fill(shape);

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

次の四角形を配置するために、上位レベルのグラフィックス状態を変換します。

//Displace on 200 to the bottom.
document.translate(0, 200);

ここでは、X軸で0.5、Y軸で0.75にスケーリングされるグラフィック状態を作成し、この新しいグラフィック状態に赤色で塗りつぶされた同じ四角形を追加します。

最後に、上位レベルのグラフィック状態で現在のグラフィック状態を終了します。

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

//Scale current graphics state on 0.5 in X axis and on 0.75f in Y axis. So we add scale component to the current transformation.
document.scale(0.5f, 0.75f);

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

//Fill the third rectangle in the current graphics state (has scale transformation)
document.fill(shape);

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

次の四角形を配置するために、上位レベルのグラフィックス状態を変換します。

//Displace upper level graphics state on 250 to the right.
document.translate(250, 0);

次に、上位レベルのグラフィックス状態に対して時計回りに45度回転した新しいグラフィックス状態を作成し、この新しいグラフィックス状態に緑色で塗りつぶされた同じ四角形を追加します。

最後に、上位レベルのグラフィックス状態にある現在のグラフィックス状態から終了します。

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

//Rotate current graphics state on 45 degrees around origin of current graphics state (350, 300). So we add rotation component to the current transformation.
document.rotate(45);

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

//Fill the fourth rectangle in the current graphics state (has rotation transformation)
document.fill(shape);

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

次の四角形をページ上の空白スペースに配置するために、上位レベルのグラフィックス状態を変換します。

//Returns upper level graphics state back to the left and displace on 200 to the bottom.
document.translate(-250, 200);

次に、せん断される新しいグラフィック状態を作成し、この新しいグラフィック状態に ピンク 色で塗りつぶされた同じ四角形を追加します。最後に、上位レベルのグラフィック状態で現在のグラフィック状態を終了します。

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

//Shear current graphics state. So we add shear component to the current transformation.
document.shear(0.1f, 0.2f);

//Set paint in the current graphics state
document.setPaint(new Color(255,192,203));

//Fill the fifth rectangle in the current graphics state (has shear transformation)
document.fill(shape);

//Restore graphics state to the previous (upper) level
document.writeGraphicsRestore();
//////////////////////////////////////////////////////////////////////////////////////////////////////////////////////

次の四角形をページ上の空白スペースに配置するために、上位レベルのグラフィックス状態を変換します。

//Displace upper level graphics state on 250 to the right.
document.translate(250, 0);

ここで、移動、拡大縮小、回転などの複雑な変換が行われる最後のグラフィックス状態を作成し、この新しいグラフィックス状態に、アクアマリン 色で塗りつぶされた同じ四角形を追加します。 最後に、上位レベルのグラフィックス状態で現在のグラフィックス状態を終了します。

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

//Transform current graphics state with complex transformation. So we add translation, scale and rotation components to the current transformation.
document.transform(new AffineTransform(1.2f, -0.965925f, 0.258819f, 1.5f, 0f, 50));

//Set paint in the current graphics state
document.setPaint(new Color(127,255,212));

//Fill the sixth rectangle in the current graphics state (has complex transformation)
document.fill(shape);

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

最後の四角形をページ上の空白スペースに配置するために、上位レベルのグラフィックス状態を変換します。

//Returns upper level graphics state back to the left and displace on 200 to the bottom.
document.translate(-250, 200);

最後に上位レベルのグラフィックス状態に再配置した塗りつぶされた四角形は、下位レベルのグラフィックス状態の変換や色の変更を受けていないことを示しています。 オレンジ色は現在のペイントのままです。

////////////////////////////////////// Again no transformation ////////////////////////////////////////////////////////
//Demonstrates that current graphics state's color is orange that was set up at the beginning of the code. 
//Fill the seventh rectangle in the current graphics state (has no transformation)
document.fill(path);
//////////////////////////////////////////////////////////////////////////////////////////////////////////////////////

最後に現在のページを閉じてドキュメントを保存します。

//Close current page
document.closePage();

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

PSドキュメントでの変換の操作については、 .NETを参照してください。

このコードを実行すると、次のようになります。

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