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é.

//Create an output stream for PostScript document
using (Stream outPsStream = new FileStream(dataDir + "HorizontalGradient_outPS.ps", FileMode.Create))
{
    //Create save options with A4 size
    PsSaveOptions options = new PsSaveOptions();

    // Create new 1-paged PS Document
    PsDocument document = new PsDocument(outPsStream, options, false);

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

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

    //Create linear gradient brush with the rectangle as 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 the brush. X and Y scale component must be equal to the width and the height of the rectangle respectively.
    //Translation components are offsets of the rectangle
    Matrix brushTransform = new Matrix(width, 0, 0, height, offsetX, offsetY);
    //Set  the transform
    brush.Transform = brushTransform;

    //Set the paint
    document.SetPaint(brush);

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

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

		//Set current stroke
		document.SetStroke(brush, 5);
    //Outline text with the 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é.

//Create an output stream for PostScript document
using (Stream outPsStream = new FileStream(dataDir + "VerticalGradient_outPS.ps", FileMode.Create))
{
    //Create save options with A4 size
    PsSaveOptions options = new PsSaveOptions();

    // Create new 1-paged PS Document
    PsDocument document = new PsDocument(outPsStream, 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 the rectangle as 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 the 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 the graphics state to get colors change in vertical direction from up to down
    brushTransform.Rotate(90);
    //Set the transform
    brush.Transform = brushTransform;

    //Set the 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é.

//Create an output stream for PostScript document
using (Stream outPsStream = new FileStream(dataDir + "DiagonaGradient_outPS.ps", FileMode.Create))
{
    //Create save options with A4 size
    PsSaveOptions options = new PsSaveOptions();

    // Create new 1-paged PS Document
    PsDocument document = new PsDocument(outPsStream, options, false);

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

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

    //Create linear gradient brush with the rectangle as bounds, start and end colors
    LinearGradientBrush brush = new LinearGradientBrush(new RectangleF(0, 0, width, height), Color.FromArgb(255, 255, 0, 0),
        Color.FromArgb(255, 0, 0, 255), 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);
    //Rotate the gradient, than scale and translate to get visible a color transition in required rectangle
    brushTransform.Rotate(-45);
    float hypotenuse = (float)System.Math.Sqrt(200 * 200 + 100 * 100);
    float ratio = hypotenuse / 200;
    brushTransform.Scale(-ratio, 1);
    brushTransform.Translate(100 / brushTransform.Elements[0], 0);

    //Set the transform
    brush.Transform = brushTransform;

    //Set the 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é.

//Create an output stream for PostScript document
using (Stream outPsStream = new FileStream(dataDir + "RadialGradient1_outPS.ps", FileMode.Create))
{
    //Create save options with A4 size
    PsSaveOptions options = new PsSaveOptions();

    // Create new 1-paged PS Document
    PsDocument document = new PsDocument(outPsStream, options, false);

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

    //Create a 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 the rectangle as bounds
    PathGradientBrush brush = new PathGradientBrush(brushRect);
    //Set interpolation colors
    brush.InterpolationColors = colorBlend;
    //Create a transform for the 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 the transform
    brush.Transform = brushTransform;

    //Set the 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é.

//Create an output stream for PostScript document
using (Stream outPsStream = new FileStream(dataDir + "RadialGradient2_outPS.ps", FileMode.Create))
{
    //Create save options with A4 size
    PsSaveOptions options = new PsSaveOptions();

    // Create new 1-paged PS Document
    PsDocument document = new PsDocument(outPsStream, options, false);

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

    //Create a 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 the rectangle as bounds
    PathGradientBrush brush = new PathGradientBrush(brushRect);
    //Set interpolation colors
    brush.InterpolationColors = colorBlend;
    //Create a transform for the 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 the transform
    brush.Transform = brushTransform;

    //Set the 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.