Работа с клипами в PostScript | .NET

Добавить обрезку в документ PS

Клип в документе PS — это путь, ограничивающий содержимое текущего состояния графики, которое будет отображаться в средстве просмотра или редакторе PS. Контент, выходящий за пределы, будет обрезан.

Путь обрезки в .NET можно назначить тремя способами:

• с помощью System.Drawing.Drawing2D.GraphicsPath, который может содержать любые замкнутые фигуры;
• по контуру текста;
• по 1 bpp (бит на пиксель) 2-цветное изображение в виде трафаретной маски;

На данный момент библиотека Aspose.Page для .NET предлагает первый и второй способы отсечения.

В приведенном ниже примере мы получаем круг System.Drawing.Drawing2D.GraphicsPath из прямоугольника в качестве обтравочного контура и отсекаем прямоугольник с синей заливкой в ​​том же графическом состоянии.

Чтобы добавить клип в новый PsDocument с помощью библиотеки Aspose.Page для .NET в этом примере, мы выполняем следующие шаги:

1. Создайте выходной поток для полученного PS-файла.
2. Создайте объект PsSaveOptions с параметрами по умолчанию.
3. Создайте одностраничный PsDocument с уже созданным потоком вывода и сохраните параметры.
4. Создайте новое графическое состояние.
5. Создайте круг System.Drawing.Drawing2D.GraphicsPath из прямоугольника.
6. Установите клип по этому пути.
7. Установите отрисовку текущего графического состояния PsDocument.
8. Заполните прямоугольник текущей краской.
9. Выход из текущего состояния графики на верхний уровень.
10. Перевести на место закрашенный прямоугольник.
11. Обведите пунктирной линией границы того же прямоугольника над закрашенным, чтобы показать границы обрезанного залитого прямоугольника.
12. Закройте страницу.
13. Сохраните документ.

// Demonstrates clipping by shape and clipping by text in PS document.

string outputFileName = "ApplyClipByShape_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);

//Create graphics path from the rectangle
GraphicsPath rectanglePath = new GraphicsPath();
rectanglePath.AddRectangle(new RectangleF(0, 0, 300, 200));

////////////////////////////////////// Clipping by shape //////////////////////////////////////////////////////////////////////

//Save graphics state in order to return back to this state after transformation
document.WriteGraphicsSave();

//Displace current graphics state on 100 points to the right and 100 points to the bottom.
document.Translate(100, 100);

//Create graphics path from the circle
GraphicsPath circlePath = new GraphicsPath();
circlePath.AddEllipse(new RectangleF(50, 0, 200, 200));

//Add clipping by circle to the current graphics state
document.Clip(circlePath);

//Set paint in the current graphics state
document.SetPaint(new SolidBrush(Color.Blue));

//Fill the rectangle in the current graphics state (with clipping)
document.Fill(rectanglePath);

//Restore graphics state to the previus (upper) level
document.WriteGraphicsRestore();

//Displace upper level graphics state on 100 points to the right and 100 points to the bottom.
document.Translate(100, 100);

Pen pen = new Pen(new SolidBrush(Color.Blue), 2);
pen.DashStyle = DashStyle.Dash;

document.SetStroke(pen);

//Draw the rectangle in the current graphics state (has no clipping) above clipped rectangle
document.Draw(rectanglePath);

//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.Rectangle будет использоваться Aspose.Page.Drawing.Rectangle, Aspose.Page.Drawing.Drawing2D.GraphicsPath будет использоваться вместо System.Drawing.Drawing2D.GraphicsPath и так далее. Наши примеры кода на GitHub содержат все необходимые замены.

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

Результат запуска этого кода выглядит так:

В следующем примере мы получаем шрифт, который обрезает прямоугольник с синей заливкой контуром текста.

Чтобы добавить вырезку по тексту в новый PsDocument с помощью библиотеки Aspose.Page для .NET, в этом примере мы выполняем следующие шаги:

1. Создайте выходной поток для полученного PS-файла.
2. Создайте объект PsSaveOptions с параметрами по умолчанию.
3. Создайте одностраничный PsDocument с уже созданным потоком вывода и сохраните параметры.
4. Создайте новое графическое состояние.
5. Создайте шрифт.
6. Установите клип с текстом и шрифтом.
7. Установите отрисовку текущего графического состояния PsDocument.
8. Заполните прямоугольник текущей краской.
9. Выход из текущего состояния графики на верхний уровень.
10. Перевести на место закрашенный прямоугольник.
11. Обведите пунктирной линией границы того же прямоугольника над закрашенным, чтобы показать границы обрезанного залитого прямоугольника.
12. Закройте страницу.
13. Сохраните документ.

// Demonstrates clipping by text in PS document.

string outputFileName = "ApplyClipByText_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);

//Create graphics path from the rectangle
GraphicsPath rectanglePath = new GraphicsPath();
rectanglePath.AddRectangle(new RectangleF(0, 0, 300, 200));

//Save graphics state in order to return back to this state after transformation
document.WriteGraphicsSave();

//Displace current graphics state on 100 points to the right and 100 points to the bottom.
document.Translate(100, 100);

Pen pen = new Pen(new SolidBrush(Color.Blue), 2);
pen.DashStyle = DashStyle.Dash;
int fontSize = 120;
System.Drawing.Font font = new System.Drawing.Font("Arial", fontSize, FontStyle.Bold);

//Clip rectangle by text's outline
document.ClipText("ABC", font, 20, fontSize + 10);

//Set paint in the current graphics state
document.SetPaint(new SolidBrush(Color.Blue));

document.Fill(rectanglePath);

document.WriteGraphicsRestore();

document.Translate(100, 100);

document.SetStroke(pen);
//Draw the rectangle in the current graphics state (has no clipping) above clipped rectangle
document.Draw(rectanglePath);

//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.Rectangle будет использоваться Aspose.Page.Drawing.Rectangle, Aspose.Page.Drawing.Drawing2D.GraphicsPath будет использоваться вместо System.Drawing.Drawing2D.GraphicsPath и так далее. Наши примеры кода на GitHub содержат все необходимые замены.

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

Результат запуска этого кода выглядит так:

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