Работа с градиентом в 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 для Java обрабатывает все важные классы, реализованные java.awt.Paint, предлагаемые платформой Java. Это java.awt.Color, java.awt.TexturePaint, java.awt.LinearGradientPaint и java.awt.RadialGradientPaint. Цвет обводки в Java назначается отдельно от свойств обводки в объекте java.awt.Stroke с повторным использованием java.awt.Paint. Таким образом, библиотека Aspose.Page для Java также может использовать полный набор реализаций Paint для рисования линий и обрисовки фигур и текста.

Чтобы рисовать графические объекты градиентом в библиотеке Aspose.Page для Java, необходимо создать java.awt.LinearGradientPaint или java.awt.RadialGradientPaint и передать его в setPaint( ) или один из методов fillText() или fillAndStrokeText(), которые принимают java.awt.Paint в качестве параметра.

Чтобы очертить графические объекты градиентом в библиотеке Aspose.Page для 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 отдельных фрагментов кода, демонстрирующих использование различных градиентов.

В этом фрагменте кода мы создаем горизонтальный линейный градиент из двух цветов, заливаем прямоугольник, заливаем текст, обводим текст этим градиентом.

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

Результат

См. работу с градиентом в документах PS в .NET.

Вы можете загрузить примеры и файлы данных с GitHub.