Работа с клипами в PS-файле | Java

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

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

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

На данный момент библиотека Aspose.Page для Java предлагает первый и второй способы отсечения. В приведенном ниже примере мы получаем форму круга в качестве обтравочного контура и отсекаем прямоугольник с синей заливкой в ​​том же графическом состоянии.

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

1. Создайте выходной поток для полученного PS-файла.
2. Создайте объект PsSaveOptions с параметрами по умолчанию.
3. Создайте одностраничный PsDocument с уже созданным потоком вывода и сохраните параметры.
4. Создайте новое графическое состояние.
5. Создайте фигуру круга (объект java.awt.geom.Ellipse2D).
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(getOutputDir() + outputFileName, options, false);

//Create graphics path from the rectangle
GeneralPath rectanglePath = new GeneralPath();
rectanglePath.append(new Rectangle2D.Float(0, 0, 300, 200), false);

////////////////////////////////////// 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
GeneralPath circlePath = new GeneralPath();
circlePath.append(new Ellipse2D.Float(50, 0, 200, 200), false);

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

//Set paint in the current graphics state
document.setPaint(Color.BLUE);

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

//Restore graphics state to the previous (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);

//Create dashed stroke similar to Pen with DashStyle.Dash
float[] dash = new float[] { 5.0f };
BasicStroke stroke = new BasicStroke(2.0f, BasicStroke.CAP_BUTT, BasicStroke.JOIN_MITER, 10.0f, dash, 0.0f);

document.setStroke(stroke);

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

См. работу с клипами в документах PS в .NET.

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

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

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

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(getOutputDir() + outputFileName, options, false);

//Create graphics path from the rectangle
GeneralPath rectanglePath = new GeneralPath();
rectanglePath.append(new Rectangle2D.Float(0, 0, 300, 200), false);

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

float[] dash = new float[] { 5.0f };
BasicStroke stroke = new BasicStroke(2.0f, BasicStroke.CAP_BUTT, BasicStroke.JOIN_MITER, 10.0f, dash, 0.0f);

int fontSize = 120;
Font font = new Font("Arial", Font.BOLD, fontSize);

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

//Set paint in the current graphics state
document.setPaint(Color.BLUE);

document.fill(rectanglePath);

document.writeGraphicsRestore();

document.translate(100, 100);

//Set paint in the current graphics state
document.setPaint(Color.BLUE);

document.setStroke(stroke);
//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();

См. работу с клипами в документах PS в .NET.

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

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