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

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

//Create an output stream for PostScript document
FileOutputStream outPsStream = new FileOutputStream(dataDir + "HorizontalGradient_outPS.ps");
//Create save options with A4 size
PsSaveOptions options = new PsSaveOptions();

//Create new PS Document with the page opened
PsDocument document = new PsDocument(outPsStream, options, false);

//Create a rectangle
Rectangle2D.Float rectangle = new Rectangle2D.Float(200, 100, 200, 100);

//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.
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(200, 0, 0, 100, 200, 100));

//Set paint
document.setPaint(paint);
//Fill the rectangle
document.fill(rectangle);

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

//Stroke a text with the gradient
document.outlineText("ABC", font, 200, 400, paint, new BasicStroke(5));

//Close current page
document.closePage();
//Save the document
document.save();

Результат запуска этого кода выглядит так:

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

//Create an output stream for PostScript document
FileOutputStream outPsStream = new FileOutputStream(dataDir + "VerticalGradient_outPS.ps");
//Create save options with A4 size
PsSaveOptions options = new PsSaveOptions();

//Create new PS Document with the page opened
PsDocument document = new PsDocument(outPsStream, options, false);

//Create a rectangle
Rectangle2D.Float rectangle = new Rectangle2D.Float(200, 100, 200, 100);

//Create arrays of colors and fractions for the gradient.
Color[] colors = { Color.RED, Color.GREEN, Color.BLUE, Color.ORANGE, new Color(85,107,47) };
float[] fractions = { 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(200, 0, 0, 100, 200, 100);
//Rotate the gradient on 90 degrees around an origin
transform.rotate(90 * (Math.PI / 180));

//Create vertical linear gradient paint.
LinearGradientPaint paint = new LinearGradientPaint(new Point2D.Float(0, 0), new Point2D.Float(200, 100),
		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();

Вот результат

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

//Create an output stream for PostScript document
FileOutputStream outPsStream = new FileOutputStream(dataDir + "DiagonalGradient_outPS.ps");
//Create save options with A4 size
PsSaveOptions options = new PsSaveOptions();

// Create new PS Document with the page opened
PsDocument document = new PsDocument(outPsStream, options, false);

//Create a rectangle
Rectangle2D.Float rectangle = new Rectangle2D.Float(200, 100, 200, 100);

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

//Close current page
document.closePage();
//Save the document
document.save();

Вот результат

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

//Create an output stream for PostScript document
FileOutputStream outPsStream = new FileOutputStream(dataDir + "RadialGradient1_outPS.ps");
//Create save options with A4 size
PsSaveOptions options = new PsSaveOptions();

//Create new PS Document with the page opened
PsDocument document = new PsDocument(outPsStream, options, false);

//Create a rectangle
Rectangle2D.Float rectangle = new Rectangle2D.Float(200, 100, 200, 200);

//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(200, 0, 0, 200, 200, 100);

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

Результат

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

//Create an output stream for PostScript document
FileOutputStream outPsStream = new FileOutputStream(dataDir + "RadialGradient2_outPS.ps");
//Create save options with A4 size
PsSaveOptions options = new PsSaveOptions();

//Create new PS Document with the page opened
PsDocument document = new PsDocument(outPsStream, options, false);

//Create a circle
Ellipse2D.Float circle = new Ellipse2D.Float(200, 100, 200, 200);

//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(200, 0, 0, 200, 200, 100);

//Create radial 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 circle
document.fill(circle);

//Close current page
document.closePage();
//Save the document
document.save();

Результат

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

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