Lavorare con il gradiente in un file PS | Java

Aggiungere un gradiente in un documento PS

In questo articolo, consideriamo i modi in cui un gradiente può essere utilizzato nei documenti PS.

Il gradiente è una transizione graduale da un colore all’altro. Viene utilizzato per rendere le immagini disegnate più realistiche. Poiché il gradiente è un tipo di pittura, è prevedibile che in Java sia implementato come sottoclasse di java.awt.Paint. In realtà, la piattaforma Java dispone di due di questi tipi di pittura:

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

Esiste anche java.awt.GradientPaint, ma è solo un caso particolare di java.awt.LinearGradientPaint.

Per impostare un colore o un tratto in PsDocument, dobbiamo passare un oggetto della classe java.awt.Paint per un disegno e un oggetto della classe java.awt.Stroke per il tratto ai rispettivi metodi. La libreria Aspose.Page per Java elabora tutte le classi importanti implementate da java.awt.Paint offerte dalla piattaforma Java. Queste sono java.awt.Color, java.awt.TexturePaint, java.awt.LinearGradientPaint e java.awt.RadialGradientPaint. Il colore del tratto in Java viene assegnato separatamente dalle proprietà del tratto nell’oggetto java.awt.Stroke, utilizzando nuovamente java.awt.Paint. Pertanto, la libreria Aspose.Page per Java può utilizzare anche un set completo di implementazioni di Paint per disegnare linee e delineare forme e testo.

Per dipingere oggetti grafici con un gradiente nella libreria Aspose.Page per Java è necessario creare java.awt.LinearGradientPaint o java.awt.RadialGradientPaint e passarlo a setPaint() o a uno dei metodi fillText() o fillAndStrokeText() che accettano java.awt.Paint come parametro.

Per delineare oggetti grafici con un gradiente nella libreria Aspose.Page per Java, è necessario passare java.awt.LinearGradientPaint o java.awt.RadialGradientPaint anche a setPaint() o a uno dei metodi outlineText() o fillAndStrokeText() che accettano il pennello come parametro.

Nell’esempio seguente mostriamo come riempire una forma e un testo e come delineare il testo con un gradiente.

Un algoritmo per dipingere oggetti grafici con un gradiente in un nuovo documento PS include i seguenti passaggi:

1. Creare un flusso di output per il file PS risultante.
2. Creare PsSaveOptions.
3. Creare PsDocument con il flusso di output già creato e le opzioni di salvataggio.
4. Creare il percorso grafico o il font necessari in base all’oggetto che si desidera riempire o delineare.
5. Creare un oggetto di tipo java.awt.LinearGradientPaint o java.awt.RadialGradientPaint in base alla forma desiderata del gradiente. 6. Impostare la trasformazione necessaria su questo pennello.
6. Impostare il pennello sfumatura come colore corrente in PsDocument.
7. Riempire il percorso grafico con il colore corrente o riempire un testo. Se utilizziamo uno dei metodi per riempire il testo che accetta java.awt.Paint come parametro, il punto precedente può essere ignorato.
8. Chiudere la pagina.
9. Salvare il documento.

Se desideriamo contornare (contornare) gli oggetti grafici con un gradiente invece degli ultimi 4 punti, il seguente sarà:

8. Impostare il gradiente come colore corrente in PsDocument.
9. Creare l’oggetto java.awt.Stroke.
10. Impostare questo tratto come tratto corrente in PsDocument.
11. Contornare il percorso grafico con il tratto corrente o contornare il testo. Se utilizziamo uno dei metodi per contornare il testo che accetta java.awt.Stroke come parametro, il punto precedente può essere ignorato.
12. Chiudi la pagina.
13. Salva il documento.

Offriamo 5 frammenti di codice separati che illustrano l’utilizzo di diversi gradienti.

In questo frammento di codice creiamo un gradiente lineare orizzontale da due colori, riempiamo un rettangolo, riempiamo un testo e tracciamo un contorno di testo con questo 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();

Il risultato dell’esecuzione di questo codice è visualizzato come

In questo frammento di codice creiamo un gradiente lineare verticale da 5 colori e riempiamo un rettangolo con questo 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();

Ecco il risultato!

In questo frammento di codice creiamo un gradiente lineare diagonale da 2 colori e riempiamo un rettangolo con questo 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();

Ecco il risultato!

In questo frammento di codice creiamo un gradiente radiale da 2 colori e riempiamo un cerchio con questo 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();

Il risultato

In questo frammento di codice creiamo un gradiente radiale da 6 colori e riempiamo un rettangolo con questo 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();

Il risultato

Vedi come lavorare con il gradiente nei documenti PS in .NET.

È possibile scaricare esempi e file di dati da GitHub.