Lavorare con le sfumature in PostScript | .NET

Aggiungere una sfumatura in un documento PS

In questo articolo, consideriamo i modi in cui una sfumatura può essere utilizzata nei documenti PS.

La sfumatura è una transizione graduale da un colore all’altro. Viene utilizzata per rendere le immagini disegnate più realistiche. Poiché la sfumatura è un tipo di pittura, è prevedibile che in .NET sia implementata come sottoclasse di System.Drawing.Brush. In realtà, la piattaforma .NET dispone di due pennelli di questo tipo:

• System.Drawing.LinearGradientBrush
• System.Drawing.PathGradientBrush

Per impostare una pittura o un tratto in PsDocument, dobbiamo passare un oggetto della classe System.Drawing.Brush per un dipinto e un oggetto di System.Drawing.Pen per il tratto ai rispettivi metodi. La libreria Aspose.Page per .NET elabora tutte le sottoclassi di System.Drawing.Brush offerte dalla piattaforma .NET. Queste sono System.Drawing.SolidBrush, System.Drawing.TextureBrush, System.Drawing.LinearGradientBrush, System.Drawing.PathGradientBrush e System.Drawing.HatchBrush. La classe System.Drawing.Pen non può essere estesa perché è sealed, ma contiene System.Drawing.Brush come proprietà e, pertanto, la libreria Aspose.Page per .NET può utilizzare un set completo di pennelli anche per disegnare linee e delineare forme e testo.

Per dipingere oggetti grafici con un gradiente nella libreria Aspose.Page per .NET, è necessario creare System.Drawing.LinearGradientBrush o System.Drawing.PathGradientBrush e passarlo a SetPaint() o a uno dei metodi FillText() o FillAndStrokeText() che accettano System.Drawing.Brush come parametro.

Per delineare oggetti grafici con un gradiente nella libreria Aspose.Page per .NET, è necessario creare System.Drawing.LinearGradientBrush o System.Drawing.PathGradientBrush, quindi creare System.Drawing.Pen con questo pennello e, infine, passarlo a SetStroke() o a uno dei metodi OutlineText() o FillAndStrokeText() che accetta System.Drawing.Pen come parametro.

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

Un algoritmo per dipingere oggetti grafici con una sfumatura 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 System.Drawing.LinearGradientBrush o System.Drawing.PathGradientBrush in base alla forma desiderata della sfumatura. 6. Impostare la trasformazione necessaria su questo pennello.
6. Impostare il pennello sfumato come tratto corrente in PsDocument.
7. Riempire il tracciato grafico con il tratto corrente o riempire un testo. Se utilizziamo uno dei metodi per riempire il testo che accetta System.Drawing.Brush 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, ecco cosa fare:

8. Creare l’oggetto System.Drawing.Pen con il pennello sfumato.

9. Impostare questa penna come tratto corrente in PsDocument.

10. Delineare il tracciato grafico con il tratto corrente o delineare il testo. Se utilizziamo uno dei metodi per delineare il testo che accetta System.Drawing.Pen come parametro, il punto precedente può essere ignorato.

11. Chiudere la pagina.

12. Salva il documento.

Offriamo 5 frammenti di codice 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(OutputDir + outputFileName, options, false);

float offsetX = 200;
float offsetY = 100;
float width = 200;
float height = 100;

//Create graphics path from the first rectangle
GraphicsPath path = new GraphicsPath();
path.AddRectangle(new RectangleF(offsetX, offsetY, width, height));

//Create linear gradient brush with rectangle as a bounds, start and end colors
LinearGradientBrush brush = new LinearGradientBrush(new RectangleF(0, 0, width, height), Color.FromArgb(150, 0, 0, 0),
    Color.FromArgb(50, 40, 128, 70), 0f);
//Create a transform for brush. X and Y scale component must be equal to width and height of the rectangle correspondingly.
//Translation components are offsets of the rectangle
Matrix brushTransform = new Matrix(width, 0, 0, height, offsetX, offsetY);
//Set transform
brush.Transform = brushTransform;

//Set paint
document.SetPaint(brush);

//Fill the rectangle
document.Fill(path);

//Fill text with gradient
System.Drawing.Font font = new System.Drawing.Font("Arial", 96, FontStyle.Bold);
document.FillAndStrokeText("ABC", font, 200, 300, brush, new Pen(new SolidBrush(Color.Black), 2));

//Set current stroke
document.SetStroke(new Pen(brush, 5));
//Outline text with gradient
document.OutlineText("ABC", font, 200, 400);

//Close current page
document.ClosePage();

//Save the document
document.Save();

Per Linux, macOS e altri sistemi operativi non Windows, offriamo l’utilizzo del nostro pacchetto Nuget Aspose.Page.Drawing. Utilizza il backend Aspose.Drawing invece della libreria di sistema System.Drawing.

Quindi, importate lo spazio dei nomi Aspose.Page.Drawing invece di quello System.Drawing. Nei frammenti di codice sopra e seguenti verrà utilizzato Aspose.Page.Drawing.RectangleF al posto di System.Drawing.RectangleF, Aspose.Page.Drawing.Drawing2D.GraphicsPath al posto di System.Drawing.Drawing2D.GraphicsPath e così via. I nostri esempi di codice su GitHub contengono tutte le sostituzioni necessarie.

Il risultato dell’esecuzione di questo codice appare come

In questo frammento di codice creiamo una sfumatura lineare verticale da 5 colori e riempiamo un rettangolo con questa sfumatura.

// 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(OutputDir + outputFileName, options, false);

float offsetX = 200;
float offsetY = 100;
float width = 200;
float height = 100;

//Create graphics path from the first rectangle
GraphicsPath path = new GraphicsPath();
path.AddRectangle(new RectangleF(offsetX, offsetY, width, height));

//Create an array of interpolation colors
Color[] colors = { Color.Red, Color.Green, Color.Blue, Color.Orange, Color.DarkOliveGreen };
float[] positions = { 0.0f, 0.1873f, 0.492f, 0.734f, 1.0f };
ColorBlend colorBlend = new ColorBlend();
colorBlend.Colors = colors;
colorBlend.Positions = positions;

//Create linear gradient brush with rectangle as a bounds, start and end colors
LinearGradientBrush brush = new LinearGradientBrush(new RectangleF(0, 0, width, height), Color.Beige, Color.DodgerBlue, 0f);
//Set interpolation colors
brush.InterpolationColors = colorBlend;
//Create a transform for brush. X and Y scale component must be equal to width and height of the rectangle correspondingly.
//Translation components are offsets of the rectangle
Matrix brushTransform = new Matrix(width, 0, 0, height, offsetX, offsetY);
//Rotate transform to get colors change in vertical direction from up to down
brushTransform.Rotate(90);
//Set transform
brush.Transform = brushTransform;

//Set paint
document.SetPaint(brush);

//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 una sfumatura lineare diagonale da 2 colori e riempiamo un rettangolo con questa sfumatura.

// Paint a circle with 2-colors 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(OutputDir + outputFileName, options, false);

float offsetX = 200;
float offsetY = 100;
float width = 200;
float height = 200;

//Create graphics path from the rectangle bounds
RectangleF bounds = new RectangleF(offsetX, offsetY, width, height);
GraphicsPath path = new GraphicsPath();
path.AddEllipse(bounds);

//Create and fill color blend object
Color[] colors = { Color.White, Color.White, Color.Blue };
float[] positions = { 0.0f, 0.2f, 1.0f };
ColorBlend colorBlend = new ColorBlend();
colorBlend.Colors = colors;
colorBlend.Positions = positions;

GraphicsPath brushRect = new GraphicsPath();
brushRect.AddRectangle(new RectangleF(0, 0, width, height));

//Create path gradient brush with rectangle as a bounds
PathGradientBrush brush = new PathGradientBrush(brushRect);
//Set interpolation colors
brush.InterpolationColors = colorBlend;
//Create a transform for brush. X and Y scale component must be equal to width and height of the rectangle correspondingly.
//Translation components are offsets of the rectangle
Matrix brushTransform = new Matrix(width, 0, 0, height, offsetX, offsetY);
//Set transform
brush.Transform = brushTransform;

//Set paint
document.SetPaint(brush);

//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 una sfumatura radiale da 2 colori e riempiamo un cerchio con questa sfumatura.

// Paint a circle with 6-colors 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(OutputDir + outputFileName, options, false);

float offsetX = 200;
float offsetY = 100;
float width = 200;
float height = 200;

//Create graphics path from the rectangle bounds
RectangleF bounds = new RectangleF(offsetX, offsetY, width, height);
GraphicsPath path = new GraphicsPath();
path.AddRectangle(bounds);

//Create and fill color blend object
Color[] colors = { Color.Green, Color.Blue, Color.Black, Color.Yellow, Color.Beige, Color.Red };
float[] positions = { 0.0f, 0.2f, 0.3f, 0.4f, 0.9f, 1.0f };
ColorBlend colorBlend = new ColorBlend();
colorBlend.Colors = colors;
colorBlend.Positions = positions;

GraphicsPath brushRect = new GraphicsPath();
brushRect.AddRectangle(new RectangleF(0, 0, width, height));

//Create path gradient brush with rectangle as a bounds
PathGradientBrush brush = new PathGradientBrush(brushRect);
//Set interpolation colors
brush.InterpolationColors = colorBlend;
//Create a transform for brush. X and Y scale component must be equal to width and height of the rectangle correspondingly.
//Translation components are offsets of the rectangle
Matrix brushTransform = new Matrix(width, 0, 0, height, offsetX, offsetY);
//Set transform
brush.Transform = brushTransform;

//Set paint
document.SetPaint(brush);

//Fill the rectangle
document.Fill(path);

//Close current page
document.ClosePage();

//Save the document
document.Save();

Il risultato

In questo frammento di codice creiamo una sfumatura radiale da 6 colori e riempiamo un rettangolo con questa sfumatura.

// Paint a circle with 2-colors 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(OutputDir + outputFileName, options, false);

float offsetX = 200;
float offsetY = 100;
float width = 200;
float height = 200;

//Create graphics path from the rectangle bounds
RectangleF bounds = new RectangleF(offsetX, offsetY, width, height);
GraphicsPath path = new GraphicsPath();
path.AddEllipse(bounds);

//Create and fill color blend object
Color[] colors = { Color.White, Color.White, Color.Blue };
float[] positions = { 0.0f, 0.2f, 1.0f };
ColorBlend colorBlend = new ColorBlend();
colorBlend.Colors = colors;
colorBlend.Positions = positions;

GraphicsPath brushRect = new GraphicsPath();
brushRect.AddRectangle(new RectangleF(0, 0, width, height));

//Create path gradient brush with rectangle as a bounds
PathGradientBrush brush = new PathGradientBrush(brushRect);
//Set interpolation colors
brush.InterpolationColors = colorBlend;
//Create a transform for brush. X and Y scale component must be equal to width and height of the rectangle correspondingly.
//Translation components are offsets of the rectangle
Matrix brushTransform = new Matrix(width, 0, 0, height, offsetX, offsetY);
//Set transform
brush.Transform = brushTransform;

//Set paint
document.SetPaint(brush);

//Fill the rectangle
document.Fill(path);

//Close current page
document.ClosePage();

//Save the document
document.Save();

Il risultato

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

È possibile scaricare esempi e file di dati da GitHub.