Робота з градієнтом у 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 фрагментів коду, які демонструють використання різних градієнтів.

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

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

Для 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 кольорів і заповнюємо цим градієнтом прямокутник.

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

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

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

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

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

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

// 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(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(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 gradient, than scale and translate to get visible 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 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();

Результат

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

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

Результат

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

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