Работа с градиентом в 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. Pen с помощью этой кисти и, наконец, передайте его 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. В приведенных выше и последующих фрагментах кода вместо System.Drawing.RectangleF будет использоваться Aspose.Page.Drawing.RectangleF, вместо System.Drawing.Drawing2D.GraphicsPath будет использоваться Aspose.Page.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();

Вот результат

В этом фрагменте кода мы создаем диагональный линейный градиент из двух цветов и заливаем этим градиентом прямоугольник.

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

Вот результат

В этом фрагменте кода мы создаем радиальный градиент из двух цветов и заполняем этим градиентом круг.

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

Результат

В этом фрагменте кода мы создаем радиальный градиент из 6 цветов и заливаем этим градиентом прямоугольник.

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

Результат

См. работу с градиентом в документах PS в Java.

Вы можете загрузить примеры и файлы данных с сайта GitHub.