在 PS 文件中使用渐变 | Java

在 PS 文档中添加渐变

本文将探讨如何在 PS 文档中使用渐变。

渐变是指颜色从一种颜色平滑过渡到另一种颜色，用于使绘制的图像更加逼真。 由于渐变是一种绘画，因此在 Java 中，它被实现为 java.awt.Paint 的子类。实际上，Java 平台有两种这样的绘画：

• 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() 或 fillText() 或 fillAndStrokeText() 方法（这些方法接受 java.awt.Paint 作为参数）。

为了在 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. 保存文档。

如果我们需要使用渐变来描边（勾勒轮廓）图形对象，而不是最后四个点，则如下所示：

8. 在 PsDocument 中将渐变设置为当前绘制。
9. 创建 java.awt.Stroke 对象。
10. 在 PsDocument 中将此描边设置为当前描边。
11. 使用当前描边勾勒图形路径或勾勒文本轮廓。如果我们使用接受 java.awt.Stroke 作为参数的勾勒文本轮廓的方法，则可以忽略上一步。
12. 关闭页面。
13. 保存文档。

我们提供了 5 个独立的代码片段，演示了不同渐变的用法。

在此代码片段中，我们用两种颜色创建水平线性渐变，填充矩形，填充文本，并使用此渐变勾勒文本轮廓。

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

结果如下

在此代码片段中，我们用两种颜色创建了一个对角线性渐变，并用该渐变填充了一个矩形。

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

结果如下

在此代码片段中，我们创建了两种颜色的径向渐变，并用该渐变填充一个圆圈。

// 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下载示例和数据文件。