Робота з градієнтом у PostScript | .NET

Додайте градієнт у документ PS

У цій статті ми розглянемо способи використання градієнта в документах PS.

Градієнт - це плавний перехід одного кольору в інший. Він використовується для того, щоб зробити намальовані зображення більш реалістичними. Оскільки градієнт є різновидом фарби, очікується, що в .NET він реалізований як підклас System.Drawing.Brush. Насправді платформа .NET має дві такі пензлі:

• System.Drawing.LinearGradientBrush

• System.Drawing.PathGradientBrush

Щоб установити фарбу або обведення в PsDocument, ми повинні передати об’єкт класу System.Drawing.Brush для малювання та об’єкт System.Drawing.Pen для обведення в відповідні методи. Бібліотека Aspose.Page для .NET обробляє всі підкласи System.Drawing.Brush, які пропонуються платформою .NET. Це System.Drawing.SolidBrush, System.Drawing.TextureBrush, System.Drawing.LinearGradientBrush, System.Drawing.PathGradientBrush і *System.Drawing.HatchBrush *. Клас System.Drawing.Pen не можна розширити, оскільки він запечатаний, але він містить System.Drawing.Brush як властивість, тому Aspose.Page для бібліотеки .NET також може використовувати повний набір пензлів також для малювання ліній і окреслення форм і тексту.

Щоб малювати графічні об’єкти градієнтом у бібліотеці Aspose.Page для .NET, необхідно створити System.Drawing.LinearGradientBrush або System.Drawing.PathGradientBrush і передати його в SetPaint () або один із методів FillText() або FillAndStrokeText(), які приймають System.Drawing.Brush як параметр.

Щоб контурувати графічні об’єкти з градієнтом у бібліотеці Aspose.Page для .NET, хтось має створити System.Drawing.LinearGradientBrush або System.Drawing.PathGradientBrush, а потім створити System.Drawing. Перо цим пензлем і, нарешті, передайте його SetStroke() або одному з методів OutlineText() або FillAndStrokeText(), який приймає *System.Drawing.Pen * як параметр.

У наведеному нижче прикладі ми демонструємо, як заповнити фігуру та текст і окреслити текст градієнтом.

Алгоритм розмальовування графічних об’єктів градієнтом у новому документі PS включає наступні кроки:

1. Створіть вихідний потік для отриманого файлу PS.
2. Створіть PsSaveOptions.
3. Створіть PsDocument із уже створеним вихідним потоком і параметрами збереження.
4. Створіть необхідний графічний шлях або шрифт в залежності від того, який об’єкт ми збираємося заповнити або окреслити.
5. Створіть об’єкт System.Drawing.LinearGradientBrush або System.Drawing.PathGradientBrush в залежності від бажаної форми градієнта.
6. Встановіть на цьому пензлі необхідну трансформацію.
7. Встановіть кисть градієнта як поточну фарбу в PsDocument
8. Заповніть графічний контур поточною фарбою або заповніть текст. Якщо ми використовуємо один із методів заповнення тексту, який приймає System.Drawing.Brush як параметр, попередній пункт можна проігнорувати.
9. Закрийте сторінку.
10. Збережіть документ.

Якщо нам потрібно обведення (контур) графічних об’єктів із градієнтом замість останніх 4 точок, наступним буде:

8. Створіть об’єкт System.Drawing.Pen за допомогою пензля градієнта.
   
9. Установіть це перо як поточний штрих у PsDocument.
   
10. Окресліть контур графіки поточним штрихом або обведіть текст. Якщо ми використовуємо один із методів для контуру тексту, який приймає System.Drawing.Pen як параметр, попередній пункт можна проігнорувати.
    
11. Закрийте сторінку.
    
12. Збережіть документ.
    

Ми пропонуємо 5 фрагментів коду, які демонструють використання різних градієнтів.

У цьому фрагменті коду ми створюємо горизонтальний лінійний градієнт із двох кольорів, заповнюємо прямокутник, заповнюємо текст, обводимо текст цим градієнтом.

//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 і 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 і Y scale component must be equal to the width і 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();
}

Для Linux, MacOS та інших операційних систем, відмінних від Windows, ми пропонуємо використовувати наш пакет Nuget Aspose.Page.Drawing. Він використовує бекенд Aspose.Drawing замість системної бібліотеки System.Drawing.

Тому імпортуйте простір імен Aspose.Page.Drawing замість System.Drawing. У наведених вище та наступних фрагментах коду Aspose.Page.Drawing.RectangleF використовуватиметься замість System.Drawing.RectangleF, Aspose.Page.Drawing.Drawing2D.GraphicsPath використовуватиметься замість System.Drawing.Drawing2D.GraphicsPath тощо. Наші приклади коду на GitHub містять усі необхідні заміни.

Результат виконання цього коду виглядає як

У цьому фрагменті коду ми створюємо вертикальний лінійний градієнт із 5 кольорів і заповнюємо цим градієнтом прямокутник.

//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 і 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 і Y scale component must be equal to width і 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();
}

Ось і результат

У цьому фрагменті коду ми створюємо діагональний лінійний градієнт із 2 кольорів і заповнюємо цим градієнтом прямокутник.

//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 і 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 і Y scale component must be equal to width і 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 і 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();
}

Ось і результат

У цьому фрагменті коду ми створюємо радіальний градієнт із 2 кольорів і заповнюємо цим градієнтом коло.

//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 і 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 і Y scale component must be equal to width і 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();
}

Результат

У цьому фрагменті коду ми створюємо радіальний градієнт із 6 кольорів і заливаємо цим градієнтом прямокутник.

//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 і 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 і Y scale component must be equal to width і 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();
}

Результат

Див. роботу з градієнтом у документах PS in Java.

Ви можете завантажити приклади і файли даних з GitHub.