PSファイルでのグラデーション操作 | Java

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

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

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

• java.awt.LinearGradientPaint
• java.awt.RadialGradientPaint

java.awt.GradientPaint も存在しますが、これは java.awt.LinearGradientPaint の特殊なケースです。

PsDocument でペイントまたはストロークを設定するには、ペイント用の java.awt.Paint クラスのオブジェクトと、ストローク用の java.awt.Stroke クラスのオブジェクトをそれぞれのメソッドに渡す必要があります。

Aspose.Page for Java ライブラリは、Java プラットフォームによって提供される java.awt.Paint が実装されたすべての重要なクラスを処理します。これらは、java.awt.Color、java.awt.TexturePaint、java.awt.LinearGradientPaint、および java.awt.RadialGradientPaint です。 Javaのストロークカラーは、java.awt.Strokeオブジェクトのストロークプロパティとは別に割り当てられ、java.awt.Paintが再び使用されます。そのため、Aspose.Page for Javaライブラリは、線の描画や図形やテキストのアウトラインにもペイントの実装をすべて使用できます。

Aspose.Page for Java ライブラリでグラフィック オブジェクトをグラデーションで ペイント するには、java.awt.LinearGradientPaint または java.awt.RadialGradientPaint を作成し、それを setPaint() または、java.awt.Paint をパラメーターとして受け取る fillText() や fillAndStrokeText() メソッドのいずれかに渡す必要があります。

Aspose.Page for Java ライブラリでグラフィック オブジェクトをグラデーションで アウトライン するには、java.awt.LinearGradientPaint または java.awt.RadialGradientPaint を、ストローク ペイントをパラメーターとして受け取る setPaint() または outlineText() や fillAndStrokeText() メソッドのいずれかに渡す必要があります。

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

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

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

最後の4点の代わりにグラデーションでグラフィックオブジェクトを*ストローク（アウトライン）*する必要がある場合は、以下の手順に従います。

8. PsDocument でグラデーションを現在のペイントとして設定します。
9. java.awt.Stroke オブジェクトを作成します。
10. このストロークを PsDocument で現在のストロークとして設定します。
11. 現在のストロークでグラフィックパスをアウトラインするか、テキストをアウトラインします。java.awt.Stroke をパラメータとして受け入れるテキストアウトライン化メソッドのいずれかを使用する場合、前の点は無視されます。
12. ページを閉じます。
13. ドキュメントを保存します。

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

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

// Paint rectangle and text and draw text with horizontal gradient fill in PS document.

String outputFileName = "HorizontalGradient_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);

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

//Create graphics path from the first rectangle
java.awt.geom.GeneralPath path = new java.awt.geom.GeneralPath();
path.append(new Rectangle2D.Float(offsetX, offsetY, width, height), false);

//Create linear gradient brush with rectangle as a bounds, start and end colors and transformation matrix
LinearGradientPaint paint = new LinearGradientPaint(new Point2D.Float(0, 0), new Point2D.Float(200, 100),
		new float [] {0, 1}, new Color [] {new Color(0, 0, 0, 150), new Color(40, 128, 70, 50)},
		MultipleGradientPaint.CycleMethod.NO_CYCLE, MultipleGradientPaint.ColorSpaceType.SRGB,
		new AffineTransform(width, 0, 0, height, offsetX, offsetY));

//Set paint
document.setPaint(paint);

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

//Fill text with gradient
java.awt.Font font = new java.awt.Font("Arial", java.awt.Font.BOLD, 96);
document.fillAndStrokeText("ABC", font, 200, 300, paint, Color.BLACK, new java.awt.BasicStroke(2));

//Set current stroke
document.setStroke(new java.awt.BasicStroke(5));
//Outline text with gradient
document.outlineText("ABC", font, 200, 400);

//Close current page
document.closePage();

//Save the document
document.save();

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

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

// Paint rectangle with vertical gradient fill in PS document.

String outputFileName = "VerticalGradient_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);

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

//Create graphics path from the first rectangle
java.awt.geom.GeneralPath path = new java.awt.geom.GeneralPath();
path.append(new Rectangle2D.Float(offsetX, offsetY, width, height), false);

//Create an array of interpolation colors
Color[] colors = { Color.RED, Color.GREEN, Color.BLUE, Color.ORANGE, new Color(107, 142, 35) }; // DarkOliveGreen
float[] positions = { 0.0f, 0.1873f, 0.492f, 0.734f, 1.0f };

//Create the gradient transform. Scale components in the transform must be equal to width and heigh of the rectangle.
//Translation components are offsets of the rectangle.
AffineTransform transform = new AffineTransform(width, 0, 0, height, offsetX, offsetY);
//Rotate the gradient on 90 degrees around an origin
transform.rotate(Math.toRadians(90));

//Create vertical linear gradient paint.
LinearGradientPaint paint = new LinearGradientPaint(new Point2D.Float(0, 0), new Point2D.Float(200, 100),
		positions, colors, MultipleGradientPaint.CycleMethod.NO_CYCLE, MultipleGradientPaint.ColorSpaceType.SRGB,
		transform);

//Set paint
document.setPaint(paint);

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

//Close current page
document.closePage();

//Save the document
document.save();

結果はこちら

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

// Paint rectangle with diagonal gradient fill in PS document.

String outputFileName = "DiagonalGradient_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);

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

//Create graphics path from the first rectangle
java.awt.geom.GeneralPath path = new java.awt.geom.GeneralPath();
path.append(new Rectangle2D.Float(offsetX, offsetY, width, height), false);

//Create the gradient transform. Scale components in the transform must be equal to width and heigh of the rectangle.
//Translation components are offsets of the rectangle.
AffineTransform transform = new AffineTransform(200, 0, 0, 100, 200, 100);
//Rotate gradient, than scale and translate to get visible color transition in required rectangle
transform.rotate(-45 * (Math.PI / 180));
float hypotenuse = (float) Math.sqrt(200 * 200 + 100 * 100);
float ratio = hypotenuse / 200;
transform.scale(-ratio, 1);
transform.translate(100 / transform.getScaleX(), 0);

//Create diagonal linear gradient paint.
LinearGradientPaint paint = new LinearGradientPaint(new Point2D.Float(0, 0), new Point2D.Float(200, 100),
		new float [] {0, 1}, new Color [] {Color.RED, Color.BLUE}, MultipleGradientPaint.CycleMethod.NO_CYCLE,
		MultipleGradientPaint.ColorSpaceType.SRGB, transform);

//Set paint
document.setPaint(paint);

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

//Close current page
document.closePage();

//Save the document
document.save();

結果はこちら

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

// Paint rectangle with radial gradient fill in PS document.

String outputFileName = "RadialGradient1_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);

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

//Create a circle
Ellipse2D.Float circle = new Ellipse2D.Float(offsetX, offsetY, width, height);

//Create arrays of colors and fractions for the gradient.
Color[] colors = { Color.WHITE, Color.WHITE, Color.BLUE };
float[] fractions = { 0.0f, 0.2f, 1.0f };

//Create horizontal linear gradient paint. Scale components in the transform must be equal to width and heigh of the rectangle.
//Translation components are offsets of the rectangle.
AffineTransform transform = new AffineTransform(width, 0, 0, height, offsetX, offsetY);

//Create radial linear gradient paint.
RadialGradientPaint paint = new RadialGradientPaint(new Point2D.Float(64, 64), 68, new Point2D.Float(24, 24),
		fractions, colors, MultipleGradientPaint.CycleMethod.NO_CYCLE, MultipleGradientPaint.ColorSpaceType.SRGB,
		transform);

//Set paint
document.setPaint(paint);

//Fill the rectangle
document.fill(circle);

//Close current page
document.closePage();

//Save the document
document.save();

結果

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

// Paint rectangle with radial gradient fill in PS document.

String outputFileName = "RadialGradient2_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);

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

//Create a rectangle
Rectangle2D.Float rectangle = new Rectangle2D.Float(offsetX, offsetY, width, height);

//Create arrays of colors and fractions for the gradient.
Color[] colors = { Color.GREEN, Color.BLUE, Color.BLACK, Color.YELLOW, new Color(245, 245, 220), Color.RED };
float[] fractions = { 0.0f, 0.2f, 0.3f, 0.4f, 0.9f, 1.0f };

//Create horizontal linear gradient paint. Scale components in the transform must be equal to width and heigh of the rectangle.
//Translation components are offsets of the rectangle.
AffineTransform transform = new AffineTransform(width, 0, 0, height, offsetX, offsetY);

//Create radial gradient paint.
RadialGradientPaint paint = new RadialGradientPaint(new Point2D.Float(300, 200), 100, new Point2D.Float(300, 200),
		fractions, colors, MultipleGradientPaint.CycleMethod.NO_CYCLE, MultipleGradientPaint.ColorSpaceType.SRGB,
		transform);

//Set paint
document.setPaint(paint);

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

//Close current page
document.closePage();

//Save the document
document.save();

結果

.NET の PS ドキュメントでのグラデーションの操作方法をご覧ください。

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