PostScript でのグラデーション操作 | .NET

PSドキュメントにグラデーションを追加する

この記事では、PSドキュメントでグラデーションを使用する方法について説明します。

グラデーションとは、ある色から別の色への滑らかな変化です。描画した画像をよりリアルに見せるために使用されます。 グラデーションはペイントの一種であるため、.NETではSystem.Drawing.Brushのサブクラスとして実装されるのが一般的です。実際、.NETプラットフォームには2つのブラシがあります。

• System.Drawing.LinearGradientBrush
• System.Drawing.PathGradientBrush

PsDocument でペイントやストロークを設定するには、ペイントの場合はSystem.Drawing.Brushクラスのオブジェクト、ストロークの場合はSystem.Drawing.Penクラスのオブジェクトをそれぞれのメソッドに渡す必要があります。 Aspose.Page for .NET ライブラリは、.NET プラットフォームで提供されている System.Drawing.Brush のすべてのサブクラスを処理します。これらのサブクラスは、System.Drawing.SolidBrush、System.Drawing.TextureBrush、System.Drawing.LinearGradientBrush、System.Drawing.PathGradientBrush、および System.Drawing.HatchBrush です。System.Drawing.Pen クラスはシールされているため拡張できませんが、System.Drawing.Brush をプロパティとして含んでいるため、Aspose.Page for .NET ライブラリでは、直線の描画や図形やテキストのアウトラインにも使用できるブラシの完全なセットを使用できます。

Aspose.Page for .NET ライブラリでグラフィック オブジェクトをグラデーションで 描画 するには、System.Drawing.LinearGradientBrush または System.Drawing.PathGradientBrush を作成し、それを SetPaint() または、System.Drawing.Brush をパラメーターとして受け取る FillText() や FillAndStrokeText() メソッドのいずれかに渡す必要があります。

Aspose.Page for .NET ライブラリでグラフィック オブジェクトをグラデーションで アウトライン するには、System.Drawing.LinearGradientBrush または System.Drawing.PathGradientBrush を作成し、このブラシを使用して System.Drawing.Pen を作成し、それを SetStroke() または、System.Drawing.Pen をパラメーターとして受け取る OutlineText() や FillAndStrokeText() メソッドのいずれかに渡す必要があります。

以下の例では、図形とテキストを塗りつぶし、グラデーションを使用してテキストのアウトラインを作成する方法を示します。

新しいPSドキュメントでグラフィックオブジェクトにグラデーションを適用するアルゴリズムは、以下の手順で構成されます。

1. 結果のPSファイル用の出力ストリームを作成します。
2. PsSaveOptions を作成します。
3. 既に作成した出力ストリームと保存オプションを使用して、 PsDocument を作成します。
4. 塗りつぶしまたはアウトライン化するオブジェクトに応じて、必要なグラフィックパスまたはフォントを作成します。
5. 希望するグラデーションの形状に応じて、System.Drawing.LinearGradientBrush または System.Drawing.PathGradientBrush オブジェクトを作成します。
6. このブラシに必要な変換を設定します。
7. PsDocument でグラデーションブラシを現在のペイントとして設定します。
8. グラフィックパスを現在のペイントで塗りつぶすか、テキストを塗りつぶします。System.Drawing.Brush をパラメータとして受け入れるテキスト塗りつぶしメソッドのいずれかを使用する場合は、前の手順は無視できます。
9. ページを閉じます。
10. ドキュメントを保存します。

最後の4つのポイントの代わりに、グラデーションを使用してグラフィックオブジェクトを ストローク（アウトライン） する必要がある場合は、次のようになります。

8. グラデーションブラシを使用して System.Drawing.Pen オブジェクトを作成します。

9. このペンを PsDocument の現在のストロークとして設定します。

10. 現在のストロークでグラフィックパスのアウトラインを作成するか、テキストのアウトラインを作成します。System.Drawing.Pen をパラメータとして受け入れるテキストのアウトライン作成方法を使用する場合は、前の手順は無視できます。

11. ページを閉じます。

12. ドキュメントを保存します。
    

さまざまなグラデーションの使い方を示す 5 つのコードスニペットを用意しました。

このコードスニペットでは、2 色で水平方向の線形グラデーションを作成し、四角形を塗りつぶし、テキストを塗りつぶし、このグラデーションでテキストのアウトラインを作成します。

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

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

    float offsetX = 200;
    float offsetY = 100;
    float width = 200;
    float height = 100;

    //Create a graphics path from the first rectangle
    GraphicsPath path = new GraphicsPath();
    path.AddRectangle(new RectangleF(offsetX, offsetY, width, height));

    //Create linear gradient brush with the rectangle as bounds, start and end colors
    LinearGradientBrush brush = new LinearGradientBrush(new RectangleF(0, 0, width, height), Color.FromArgb(150, 0, 0, 0),
        Color.FromArgb(50, 40, 128, 70), 0f);
    //Create a transform for the brush. X and Y scale component must be equal to the width and the height of the rectangle respectively.
    //Translation components are offsets of the rectangle
    Matrix brushTransform = new Matrix(width, 0, 0, height, offsetX, offsetY);
    //Set  the transform
    brush.Transform = brushTransform;

    //Set the paint
    document.SetPaint(brush);

    //Fill the rectangle
    document.Fill(path);

    //Fill the text with the gradient
    Font font = new Font("Arial", 96, FontStyle.Bold);
    document.FillAndStrokeText("ABC", font, 200, 300, brush, new Pen(new SolidBrush(Color.Black), 2));

		//Set current stroke
		document.SetStroke(brush, 5);
    //Outline text with the gradient
    document.OutlineText("ABC", font, 200, 400);

    //Close current page
    document.ClosePage();

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

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のコード例に記載されています。

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

このコードスニペットでは、5色で垂直方向の線形グラデーションを作成し、このグラデーションで四角形を塗りつぶします。

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

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

    float offsetX = 200;
    float offsetY = 100;
    float width = 200;
    float height = 100;

    //Create graphics path from the first rectangle
    GraphicsPath path = new GraphicsPath();
    path.AddRectangle(new RectangleF(offsetX, offsetY, width, height));

    //Create an array of interpolation colors
    Color[] colors = { Color.Red, Color.Green, Color.Blue, Color.Orange, Color.DarkOliveGreen };
    float[] positions = { 0.0f, 0.1873f, 0.492f, 0.734f, 1.0f };
    ColorBlend colorBlend = new ColorBlend();
    colorBlend.Colors = colors;
    colorBlend.Positions = positions;

    //Create linear gradient brush with the rectangle as bounds, start and end colors
    LinearGradientBrush brush = new LinearGradientBrush(new RectangleF(0, 0, width, height), Color.Beige, Color.DodgerBlue, 0f);
    //Set interpolation colors
    brush.InterpolationColors = colorBlend;
    //Create a transform for the brush. X and Y scale component must be equal to width and height of the rectangle correspondingly.
    //Translation components are offsets of the rectangle
    Matrix brushTransform = new Matrix(width, 0, 0, height, offsetX, offsetY);
    //Rotate the graphics state to get colors change in vertical direction from up to down
    brushTransform.Rotate(90);
    //Set the transform
    brush.Transform = brushTransform;

    //Set the paint
    document.SetPaint(brush);

    //Fill the rectangle
    document.Fill(path);

    //Close current page
    document.ClosePage();

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

結果はこちらです

このコードスニペットでは、2色で斜めの線形グラデーションを作成し、このグラデーションで四角形を塗りつぶしています。

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

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

    float offsetX = 200;
    float offsetY = 100;
    float width = 200;
    float height = 100;

    //Create a graphics path from the first rectangle
    GraphicsPath path = new GraphicsPath();
    path.AddRectangle(new RectangleF(offsetX, offsetY, width, height));

    //Create linear gradient brush with the rectangle as bounds, start and end colors
    LinearGradientBrush brush = new LinearGradientBrush(new RectangleF(0, 0, width, height), Color.FromArgb(255, 255, 0, 0),
        Color.FromArgb(255, 0, 0, 255), 0f);

    //Create a transform for brush. X and Y scale component must be equal to width and height of the rectangle correspondingly.
    //Translation components are offsets of the rectangle        
    Matrix brushTransform = new Matrix(width, 0, 0, height, offsetX, offsetY);
    //Rotate the gradient, than scale and translate to get visible a color transition in required rectangle
    brushTransform.Rotate(-45);
    float hypotenuse = (float)System.Math.Sqrt(200 * 200 + 100 * 100);
    float ratio = hypotenuse / 200;
    brushTransform.Scale(-ratio, 1);
    brushTransform.Translate(100 / brushTransform.Elements[0], 0);

    //Set the transform
    brush.Transform = brushTransform;

    //Set the paint
    document.SetPaint(brush);

    //Fill the rectangle
    document.Fill(path);

    //Close current page
    document.ClosePage();

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

結果はこちらです

このコードスニペットでは、2色で放射状グラデーションを作成し、円をこのグラデーションで塗りつぶしています。

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

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

    float offsetX = 200;
    float offsetY = 100;
    float width = 200;
    float height = 200;

    //Create a graphics path from the rectangle bounds
    RectangleF bounds = new RectangleF(offsetX, offsetY, width, height);
    GraphicsPath path = new GraphicsPath();
    path.AddEllipse(bounds);

    //Create and fill color blend object
    Color[] colors = { Color.White, Color.White, Color.Blue };
    float[] positions = { 0.0f, 0.2f, 1.0f };
    ColorBlend colorBlend = new ColorBlend();
    colorBlend.Colors = colors;
    colorBlend.Positions = positions;

    GraphicsPath brushRect = new GraphicsPath();
    brushRect.AddRectangle(new RectangleF(0, 0, width, height));

    //Create path gradient brush with the rectangle as bounds
    PathGradientBrush brush = new PathGradientBrush(brushRect);
    //Set interpolation colors
    brush.InterpolationColors = colorBlend;
    //Create a transform for the brush. X and Y scale component must be equal to width and height of the rectangle correspondingly.
    //Translation components are offsets of the rectangle
    Matrix brushTransform = new Matrix(width, 0, 0, height, offsetX, offsetY);
    //Set the transform
    brush.Transform = brushTransform;

    //Set the paint
    document.SetPaint(brush);

    //Fill the rectangle
    document.Fill(path);

    //Close current page
    document.ClosePage();

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

結果

このコードスニペットでは、6色で放射状グラデーションを作成し、このグラデーションで四角形を塗りつぶしています。

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

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

    float offsetX = 200;
    float offsetY = 100;
    float width = 200;
    float height = 200;

    //Create a graphics path from the rectangle bounds
    RectangleF bounds = new RectangleF(offsetX, offsetY, width, height);
    GraphicsPath path = new GraphicsPath();
    path.AddRectangle(bounds);

    //Create and fill color blend object
    Color[] colors = { Color.Green, Color.Blue, Color.Black, Color.Yellow, Color.Beige, Color.Red };
    float[] positions = { 0.0f, 0.2f, 0.3f, 0.4f, 0.9f, 1.0f };
    ColorBlend colorBlend = new ColorBlend();
    colorBlend.Colors = colors;
    colorBlend.Positions = positions;

    GraphicsPath brushRect = new GraphicsPath();
    brushRect.AddRectangle(new RectangleF(0, 0, width, height));

    //Create path gradient brush with the rectangle as bounds
    PathGradientBrush brush = new PathGradientBrush(brushRect);
    //Set interpolation colors
    brush.InterpolationColors = colorBlend;
    //Create a transform for the brush. X and Y scale component must be equal to width and height of the rectangle correspondingly.
    //Translation components are offsets of the rectangle
    Matrix brushTransform = new Matrix(width, 0, 0, height, offsetX, offsetY);
    //Set the transform
    brush.Transform = brushTransform;

    //Set the paint
    document.SetPaint(brush);

    //Fill the rectangle
    document.Fill(path);

    //Close current page
    document.ClosePage();

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

結果

PSドキュメントでのグラデーションの操作については、 Javaをご覧ください。

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