Trabalhar com Gradiente em ficheiro PS | Java

Adicionar Gradiente em Documento PS

Neste artigo, consideramos as formas como um gradiente pode ser utilizado em documentos de PS.

O gradiente é uma transição suave de uma cor para outra. É utilizado para tornar as imagens desenhadas mais realistas. Como o gradiente é um tipo de tinta, é esperado que em Java seja implementado como uma subclasse de java.awt.Paint. Na verdade, a plataforma Java possui duas destas tintas:

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

Existe também java.awt.GradientPaint, mas é apenas um caso particular de java.awt.LinearGradientPaint.

Para definir uma pintura ou um traço em PsDocument, precisamos de passar um objeto da classe java.awt.Paint para uma pintura e um objeto da classe java.awt.Stroke para o traço nos respetivos métodos. A biblioteca Aspose.Page para Java processa todas as classes importantes implementadas em java.awt.Paint oferecidas pela plataforma Java. São elas: java.awt.Color, java.awt.TexturePaint, java.awt.LinearGradientPaint e java.awt.RadialGradientPaint. A cor do traço em Java é atribuída separadamente das propriedades do traço no objeto java.awt.Stroke, utilizando novamente java.awt.Paint. Por conseguinte, a biblioteca Aspose.Page para Java também pode utilizar um conjunto completo de implementações de pintura para desenhar linhas e delinear formas e texto.

Para pintar objetos gráficos com um gradiente na biblioteca Aspose.Page para Java, é necessário criar java.awt.LinearGradientPaint ou java.awt.RadialGradientPaint e passá-los para setPaint() ou um dos métodos fillText() ou fillAndStrokeText() que aceitam java.awt.Paint como parâmetro.

Para contornar os objetos gráficos com um gradiente na biblioteca Aspose.Page para Java, é necessário passar java.awt.LinearGradientPaint ou java.awt.RadialGradientPaint também para setPaint() ou um dos métodos outlineText() ou fillAndStrokeText() que aceitam pintura de traços como parâmetro.

No exemplo abaixo, demonstramos como preencher uma forma e um texto e contornar o texto com um gradiente.

Um algoritmo para pintar objetos gráficos com um gradiente num novo documento PS inclui os seguintes passos:

1. Crie um fluxo de saída para o ficheiro PS resultante.
2. Crie PsSaveOptions.
3. Crie PsDocument com o fluxo de saída já criado e as opções de guardar.
4. Crie o caminho gráfico ou a fonte necessária, dependendo do objeto que iremos preencher ou contornar.
5. Crie um objeto a partir de java.awt.LinearGradientPaint ou java.awt.RadialGradientPaint, dependendo da forma desejada do gradiente.
6. Defina a transformação necessária neste pincel.
7. Defina o pincel de gradiente como a pintura atual no PsDocument
8. Preencha o percurso gráfico com a pintura atual ou preencha um texto. Se utilizarmos um dos métodos de preenchimento de texto que aceita java.awt.Paint como parâmetro, o ponto anterior pode ser ignorado.
9. Feche a página.
10. Guarde o documento.

Se precisarmos de traçar (contornar) objetos gráficos com um gradiente em vez dos últimos 4 pontos, o seguinte será:

8. Defina o gradiente como a pintura atual no PsDocument.
9. Crie o objeto java.awt.Stroke.
10. Defina este traço como o traço atual no PsDocument.
11. Contorne o percurso gráfico com o traço atual ou contorne o texto. Se utilizarmos um dos métodos de contorno de texto que aceita java.awt.Stroke como parâmetro, o ponto anterior pode ser ignorado.
12. Feche a página.
13. Guarde o documento.

Oferecemos 5 excertos de código separados que demonstram a utilização de diferentes gradientes.

Neste excerto de código, criamos um gradiente linear horizontal a partir de duas cores, preenchemos um retângulo, preenchemos um texto e contornamos um texto com este gradiente.

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

O resultado da execução deste código é apresentado como

Neste excerto de código, criamos um gradiente linear vertical com 5 cores e preenchemos um retângulo com esse gradiente.

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

Aí vem o resultado

Neste trecho de código, criamos um gradiente linear diagonal a partir de 2 cores e preenchemos um retângulo com esse gradiente.

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

Aí vem o resultado

Neste trecho de código, criamos um gradiente radial a partir de 2 cores e preenchemos um círculo com esse gradiente.

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

O resultado

Neste trecho de código, criamos um gradiente radial a partir de 6 cores e preenchemos um retângulo com esse gradiente.

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

O resultado

Veja como trabalhar com gradiente em documentos PS em .NET.

Pode descarregar exemplos e ficheiros de dados do GitHub.