Работа с клипами в 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. Сохраните документ.

//Create an output stream for the PostScript document
FileOutputStream outPsStream = new FileOutputStream(dataDir + "Clipping_outPS.ps");
//Create save options with A4 size
PsSaveOptions options = new PsSaveOptions();

// Create a new PS Document with the page opened
PsDocument document = new PsDocument(outPsStream, options, false);

//Create a rectangle
Shape rectangle = new Rectangle2D.Float(0, 0, 300, 200);

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

//Save the  graphics state to return back to this state after the transformation
document.writeGraphicsSave();

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

//Create a circle shape
Shape circle = new Ellipse2D.Float(50, 0, 200, 200);

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

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

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

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

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

document.setStroke(stroke);

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

//Close the 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. Сохраните документ.

//Create output stream for PostScript document
FileOutputStream outPsStream = new FileOutputStream(dataDir + "Clipping_outPS.ps");
//Create save options with A4 size
PsSaveOptions options = new PsSaveOptions();

// Create a new PS Document with the page opened
PsDocument document = new PsDocument(outPsStream, options, false);

//Create a rectangle
Shape rectangle = new Rectangle2D.Float(0, 0, 300, 200);

//Set paint in the upper-level graphics state
document.setPaint(Color.BLUE);

//Save graphics state to return back to this state after the transformation
document.writeGraphicsSave();

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

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

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

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

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

document.setStroke(stroke);

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

//Close the current page
document.closePage();
//Save the document
document.save();

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

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

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