Travailler avec le dégradé dans PS | .NET

Ajouter un dégradé dans un document PS

Dans cet article, nous examinons les manières dont un dégradé peut être utilisé dans les documents PS.

Le dégradé est une transition douce d’une couleur à une autre. Il est utilisé pour rendre les images dessinées plus réalistes. Comme le dégradé est une sorte de peinture, on s’attend à ce qu’il soit implémenté dans .NET en tant que sous-classe de System.Drawing.Brush. En fait, la plate-forme .NET dispose de deux de ces pinceaux :

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

Afin de définir de la peinture ou un trait dans PsDocument, nous devons passer un objet de la classe System.Drawing.Brush pour une peinture et un objet de System.Drawing.Pen pour le trait dans méthodes respectives. La bibliothèque Aspose.Page pour .NET traite toutes les sous-classes de System.Drawing.Brush proposées par la plateforme .NET. Il s’agit de System.Drawing.SolidBrush, System.Drawing.TextureBrush, System.Drawing.LinearGradientBrush, System.Drawing.PathGradientBrush et *System.Drawing.HatchBrush. *. La classe System.Drawing.Pen ne peut pas être étendue car elle est scellée, mais elle contient System.Drawing.Brush comme propriété et, par conséquent, la bibliothèque Aspose.Page pour .NET peut également utiliser un ensemble complet de pinceaux également pour dessiner des lignes et décrire des formes et du texte.

Afin de peindre des objets graphiques avec un dégradé dans la bibliothèque Aspose.Page pour .NET, il est nécessaire de créer System.Drawing.LinearGradientBrush ou System.Drawing.PathGradientBrush et de le transmettre à SetPaint () ou l’une des méthodes FillText() ou FillAndStrokeText() qui acceptent System.Drawing.Brush comme paramètre.

Afin de décrire des objets graphiques avec un dégradé dans la bibliothèque Aspose.Page pour .NET, quelqu’un doit créer System.Drawing.LinearGradientBrush ou System.Drawing.PathGradientBrush, puis créer System.Drawing. Stylo avec ce pinceau et, enfin, transmettez-le à SetStroke() ou à l’une des méthodes OutlineText() ou FillAndStrokeText() qui accepte *System.Drawing.Pen * comme paramètre.

Dans l’exemple ci-dessous, nous montrons comment remplir une forme et un texte et décrire le texte avec un dégradé.

Un algorithme pour peindre des objets graphiques avec un dégradé dans un nouveau document PS comprend les étapes suivantes :

1. Créez un flux de sortie pour le fichier PS résultant.
2. Créez PsSaveOptions.
3. Créez PsDocument avec le flux de sortie déjà créé et enregistrez les options.
4. Créez le chemin graphique ou la police nécessaire en fonction de l’objet que nous allons remplir ou décrire.
5. Créez un objet de System.Drawing.LinearGradientBrush ou System.Drawing.PathGradientBrush en fonction de la forme pieux d’un dégradé.
6. Définissez la transformation nécessaire sur ce pinceau.
7. Définissez le pinceau dégradé comme peinture actuelle dans PsDocument
8. Remplissez le chemin graphique avec la peinture actuelle ou remplissez un texte. Si nous utilisons l’une des méthodes de remplissage du texte qui accepte System.Drawing.Brush comme paramètre, le point précédent peut être ignoré.
9. Fermez la page.
10. Enregistrez le document.

Si nous avons besoin de tracer (décrire) des objets graphiques avec un dégradé au lieu des 4 derniers points, ce qui suit sera :8. Créez l’objet System.Drawing.Pen avec le pinceau dégradé.

9. Définissez ce stylet comme trait actuel dans PsDocument.

10. Décrivez le chemin graphique avec le trait actuel ou décrivez le texte. Si nous utilisons l’une des méthodes pour décrire le texte qui accepte System.Drawing.Pen comme paramètre, le point précédent peut être ignoré.

11. Fermez la page.

12. Enregistrez le document.
    

Nous proposons 5 extraits de code qui démontrent l’utilisation de différents dégradés.

Dans cet extrait de code, nous créons un dégradé linéaire horizontal à partir de deux couleurs, remplissons un rectangle, remplissons un texte, décrivons un texte avec ce dégradé.

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

Pour Linux, MacOS et autres systèmes d’exploitation non Windows, nous proposons d’utiliser notre package Nuget Aspose.Page.Drawing. Il utilise le backend Aspose.Drawing au lieu de la bibliothèque système System.Drawing.

Importez donc l’espace de noms Aspose.Page.Drawing au lieu de celui de System.Drawing. Dans les extraits de code ci-dessus et suivants, Aspose.Page.Drawing.RectangleF sera utilisé à la place de System.Drawing.RectangleF, Aspose.Page.Drawing.Drawing2D.GraphicsPath sera utilisé à la place de System.Drawing.Drawing2D.GraphicsPath et ainsi de suite. Nos exemples de code sur GitHub contiennent toutes les substitutions nécessaires.

Le résultat de l’exécution de ce code apparaît comme

Dans cet extrait de code, nous créons un dégradé linéaire vertical à partir de 5 couleurs et remplissons un rectangle avec ce dégradé.

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

Voici le résultat

Dans cet extrait de code, nous créons un dégradé linéaire diagonal à partir de 2 couleurs et remplissons un rectangle avec ce dégradé.

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

Voici le résultat

Dans cet extrait de code, nous créons un dégradé radial à partir de 2 couleurs et remplissons un cercle avec ce dégradé.

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

Le résultat

Dans cet extrait de code, nous créons un dégradé radial à partir de 6 couleurs et remplissons un rectangle avec ce dégradé.

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

Le résultat

Voir Travailler avec un dégradé dans les documents PS dans Java.

Vous pouvez télécharger des exemples et des fichiers de données à partir de GitHub.