PostScript での変換の操作 | .NET

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

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

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

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

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

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

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

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

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

    document.Translate(100, 100);

    //Create graphics path from the rectangle
    GraphicsPath path = new GraphicsPath();
    path.AddRectangle(new RectangleF(0, 0, 150, 100));

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

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

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

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

////////////////////////////////////// No transformations ///////////////////////////////////////////////////////////////
    //Set a paint in graphics state on upper level
    document.SetPaint(new SolidBrush(Color.Orange));

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

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

////////////////////////////////////// Translation //////////////////////////////////////////////////////////////////////

    //Save the 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 the paint in the current graphics state
    document.SetPaint(new SolidBrush(Color.Blue));

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

    //Restore the 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 the paint in the current graphics state
    document.SetPaint(new SolidBrush(Color.Red));

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

    //Restore the 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 the 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 the paint in the current graphics state
    document.SetPaint(new SolidBrush(Color.Green));

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

    //Restore the 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 the 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 the paint in the current graphics state
    document.SetPaint(new SolidBrush(Color.Pink));

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

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

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

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

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

////////////////////////////////////// Complex transformation ////////////////////////////////////////////////////////
    //Save the 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 Matrix(1.2f, -0.965925f, 0.258819f, 1.5f, 0f, 50));
	
    //Set the paint in the current graphics state
    document.SetPaint(new SolidBrush(Color.Aquamarine));
	
    //Fill the sixth rectangle in the current graphics state (has complex transformation)
    document.Fill(path);
	
    //Restore the 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ドキュメントでの変換の操作については、 Java を参照してください。

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

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