Настройка фигур презентаций в Python через Java

О чём эта страница

Создавайте и настраивайте фигуры в презентациях PowerPoint с помощью Aspose.Slides для Python через Java: пути геометрии, скруглённые углы, составные фигуры.

Обзор

В этой статье объясняется, как настраивать фигуры презентаций в Aspose.Slides, редактируя их геометрию с помощью точек редактирования и путей геометрии. Показано, как работать с GeometryPath для изменения существующих фигур, выполнять базовые операции редактирования пути, добавлять или удалять точки и применять обновлённую геометрию к фигуре.

Также демонстрируется, как создавать пользовательские и составные фигуры, строить фигуры со скруглёнными углами, определять, замкнута ли геометрия фигуры, и преобразовывать между GeometryPath и java.awt.Shape для дополнительных сценариев настройки геометрии.

Изменение фигуры с помощью точек редактирования

Рассмотрим квадрат. В PowerPoint, используя точки редактирования, вы можете

перемещать угол квадрата внутрь или наружу
задавать кривизну угла или точки
добавлять новые точки к квадрату
манипулировать точками квадрата и т.д.

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

Советы по редактированию фигур

overview_image

Прежде чем начинать редактирование фигур PowerPoint через точки редактирования, учитывайте следующее:

Фигура (или её путь) может быть закрытой или открытой.
Когда фигура закрыта, у неё нет начальной или конечной точки. Когда фигура открыта, у неё есть начало и конец.
Все фигуры состоят как минимум из 2‑х якорных точек, соединённых линиями.
Линия может быть прямой или кривой. Якорные точки определяют характер линии.
Якорные точки бывают угловыми, прямыми или плавными:
- Угловая точка – это точка, где соединяются 2 прямые линии под углом.
- Плавная точка – это точка, где 2 ручки находятся на одной прямой, а сегменты линии соединяются плавной кривой. В этом случае все ручки находятся на одинаковом расстоянии от якорной точки.
- Прямая точка – это точка, где 2 ручки находятся на одной прямой, но сегменты линии соединяются плавной кривой без требования одинакового расстояния ручек от якорной точки.
Перемещая или редактируя якорные точки (что меняет угол линий), вы меняете внешний вид фигуры.

Для редактирования фигур PowerPoint через точки редактирования Aspose.Slides предоставляет класс GeometryPath.

Экземпляр GeometryPath представляет путь геометрии объекта GeometryShape.
Чтобы получить GeometryPath из экземпляра GeometryShape, используйте метод GeometryShape.getGeometryPaths.
Чтобы задать GeometryPath для фигуры, используйте методы: GeometryShape.setGeometryPath для сплошных фигур и GeometryShape.setGeometryPaths для составных фигур.
Чтобы добавить сегменты, используйте методы класса GeometryPath.
С помощью методов GeometryPath.setStroke и GeometryPath.setFillMode можно задать внешний вид пути геометрии.
Метод GeometryPath.getPathData позволяет получить путь геометрии GeometryShape в виде массива сегментов пути.
Для доступа к дополнительным параметрам настройки геометрии фигур можно преобразовать GeometryPath в java.awt.Shape.
Используйте методы geometryPathToGraphicsPath и graphicsPathToGeometryPath (из класса ShapeUtil) для преобразования GeometryPath в java.awt.Shape и обратно.

Простые операции редактирования

Ниже представлены сигнатуры базовых операций редактирования:

Добавить линию в конец пути:

geometry_path.lineTo(point)
geometry_path.lineTo(x, y)

Добавить линию в указанную позицию пути:

geometry_path.lineTo(point, index)
geometry_path.lineTo(x, y, index)

Добавить кубическую кривую Безье в конец пути:

geometry_path.cubicBezierTo(point1, point2, point3)
geometry_path.cubicBezierTo(x1, y1, x2, y2, x3, y3)

Добавить кубическую кривую Безье в указанную позицию пути:

geometry_path.cubicBezierTo(point1, point2, point3, index)
geometry_path.cubicBezierTo(x1, y1, x2, y2, x3, y3, index)

Добавить квадратичную кривую Безье в конец пути:

geometry_path.quadraticBezierTo(point1, point2)
geometry_path.quadraticBezierTo(x1, y1, x2, y2)

Добавить квадратичную кривую Безье в указанную позицию пути:

geometry_path.quadraticBezierTo(point1, point2, index)
geometry_path.quadraticBezierTo(x1, y1, x2, y2, index)

Добавить заданную дугу к пути:

geometry_path.arcTo(width, height, start_angle, sweep_angle)

Замкнуть текущую фигуру пути:

geometry_path.closeFigure()

Установить позицию для следующей точки:

geometry_path.moveTo(point)
geometry_path.moveTo(x, y)

Удалить сегмент пути по указанному индексу:

geometry_path.removeAt(index)

Добавление пользовательских точек к фигуре

Создайте экземпляр класса GeometryShape и задайте тип ShapeType.Rectangle.
Получите экземпляр класса GeometryPath из фигуры.
Добавьте новую точку между двумя верхними точками пути.
Добавьте новую точку между двумя нижними точками пути.
Примените путь к фигуре.

Этот код на Python показывает, как добавить пользовательские точки к фигуре:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, ShapeType

presentation = Presentation()
try:
    shape = presentation.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 200, 100)
    geometry_path = shape.getGeometryPaths()[0]
    geometry_path.lineTo(100, 50, 1)
    geometry_path.lineTo(100, 50, 4)
    shape.setGeometryPath(geometry_path)
finally:
    presentation.dispose()

example1_image

Удаление точек из фигуры

Создайте экземпляр класса GeometryShape и задайте тип ShapeType.Heart.
Получите экземпляр класса GeometryPath из фигуры.
Удалите сегмент пути.
Примените путь к фигуре.

Этот код на Python показывает, как удалить точки из фигуры:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, ShapeType

presentation = Presentation()
try:
    shape = presentation.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Heart, 100, 100, 300, 300)
    geometry_path = shape.getGeometryPaths()[0]
    geometry_path.removeAt(2)
    shape.setGeometryPath(geometry_path)
finally:
    presentation.dispose()

example2_image

Создание пользовательской фигуры

Вычислите точки для фигуры.
Создайте экземпляр класса GeometryPath.
Заполните путь точками.
Создайте экземпляр класса GeometryShape.
Примените путь к фигуре.

Этот код на Python показывает, как создать пользовательскую фигуру:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, ShapeType, GeometryPath

import math

points = []
outer_radius = 100
inner_radius = 50
step = 72

for angle in range(-90, 270, step):
    radians = math.radians(angle)
    x = outer_radius * math.cos(radians)
    y = outer_radius * math.sin(radians)
    points.append((x + outer_radius, y + outer_radius))

    radians = math.radians(angle + step / 2)
    x = inner_radius * math.cos(radians)
    y = inner_radius * math.sin(radians)
    points.append((x + outer_radius, y + outer_radius))

star_path = GeometryPath()
star_path.moveTo(*points[0])
for point in points[1:]:
    star_path.lineTo(*point)
star_path.closeFigure()

presentation = Presentation()
try:
    shape = presentation.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, outer_radius * 2, outer_radius * 2)
    shape.setGeometryPath(star_path)
finally:
    presentation.dispose()

example3_image

Создание составной пользовательской фигуры

Создайте экземпляр класса GeometryShape.
Создайте первый экземпляр класса GeometryPath.
Создайте второй экземпляр класса GeometryPath.
Примените пути к фигуре.

Этот код на Python показывает, как создать составную пользовательскую фигуру:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, ShapeType, GeometryPath

presentation = Presentation()
try:
    shape = presentation.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 200, 100)

    top_path = GeometryPath()
    top_path.moveTo(0, 0)
    top_path.lineTo(shape.getWidth(), 0)
    top_path.lineTo(shape.getWidth(), shape.getHeight() / 3)
    top_path.lineTo(0, shape.getHeight() / 3)
    top_path.closeFigure()

    bottom_path = GeometryPath()
    bottom_path.moveTo(0, shape.getHeight() / 3 * 2)
    bottom_path.lineTo(shape.getWidth(), shape.getHeight() / 3 * 2)
    bottom_path.lineTo(shape.getWidth(), shape.getHeight())
    bottom_path.lineTo(0, shape.getHeight())
    bottom_path.closeFigure()

    shape.setGeometryPaths([top_path, bottom_path])
finally:
    presentation.dispose()

example4_image

Создание пользовательской фигуры со скруглёнными углами

Этот код на Python показывает, как создать пользовательскую фигуру со скруглёнными углами (внутренняя кривизна):

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, ShapeType, GeometryPath, SaveFormat

shape_x = 20
shape_y = 20
shape_width = 300
shape_height = 200

left_top_size = 50
right_top_size = 20
right_bottom_size = 40
left_bottom_size = 10

presentation = Presentation()
try:
    shape = presentation.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Custom, shape_x, shape_y, shape_width, shape_height)
    geometry_path = GeometryPath()
    geometry_path.moveTo(left_top_size, 0)
    geometry_path.lineTo(shape_width - right_top_size, 0)
    geometry_path.arcTo(right_top_size, right_top_size, 180, -90)
    geometry_path.lineTo(shape_width, shape_height - right_bottom_size)
    geometry_path.arcTo(right_bottom_size, right_bottom_size, -90, -90)
    geometry_path.lineTo(left_bottom_size, shape_height)
    geometry_path.arcTo(left_bottom_size, left_bottom_size, 0, -90)
    geometry_path.lineTo(0, left_top_size)
    geometry_path.arcTo(left_top_size, left_top_size, 90, -90)
    geometry_path.closeFigure()
    shape.setGeometryPath(geometry_path)
    presentation.save("output.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Определение, является ли геометрия фигуры замкнутой

Замкнутая фигура определяется как такая, у которой все стороны соединены, образуя единую границу без разрывов. Такая фигура может быть простой геометрической формой или сложным пользовательским контуром. Следующий пример кода демонстрирует, как проверить, замкнута ли геометрия фигуры:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import PathCommandType

def is_geometry_closed(geometry_shape):
    is_closed = False
    for geometry_path in geometry_shape.getGeometryPaths():
        path_data = geometry_path.getPathData()
        if len(path_data) == 0:
            continue
        last_segment = path_data[-1]
        is_closed = last_segment.getPathCommand() == PathCommandType.Close
        if not is_closed:
            return False
    return is_closed

Преобразование GeometryPath в java.awt.Shape

Создайте экземпляр класса GeometryShape.
Создайте экземпляр класса java.awt.Shape.
Преобразуйте экземпляр java.awt.Shape в экземпляр GeometryPath путём обхода его PathIterator и воспроизведения каждого сегмента на пути.
Примените пути к фигуре.

Этот код на Python реализует описанные шаги для преобразования графического пути в путь геометрии:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, ShapeType, GeometryPath, PathFillModeType

from java.awt import Font
from java.awt.geom import PathIterator
from java.awt.image import BufferedImage

presentation = Presentation()
try:
    # Создать новую фигуру.
    shape = presentation.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 300, 100)

    # Получить путь геометрии фигуры.
    original_path = shape.getGeometryPaths()[0]
    original_path.setFillMode(PathFillModeType.None_)

    # Создать новый графический путь с текстом.
    font = Font("Arial", Font.PLAIN, 40)
    text = "Text in shape"
    image = BufferedImage(100, 100, BufferedImage.TYPE_INT_ARGB)
    graphics = image.createGraphics()
    try:
        glyph_vector = font.createGlyphVector(graphics.getFontRenderContext(), text)
        graphics_path = glyph_vector.getOutline(20.0, -glyph_vector.getVisualBounds().getY() + 10)
    finally:
        graphics.dispose()

    # Преобразовать графический путь в путь геометрии.
    text_path = GeometryPath()
    path_iterator = graphics_path.getPathIterator(None)
    points = jpype.JArray(jpype.JFloat)(6)
    while not path_iterator.isDone():
        segment_type = path_iterator.currentSegment(points)
        if segment_type == PathIterator.SEG_MOVETO:
            text_path.moveTo(points[0], points[1])
        elif segment_type == PathIterator.SEG_LINETO:
            text_path.lineTo(points[0], points[1])
        elif segment_type == PathIterator.SEG_QUADTO:
            text_path.quadraticBezierTo(points[0], points[1], points[2], points[3])
        elif segment_type == PathIterator.SEG_CUBICTO:
            text_path.cubicBezierTo(points[0], points[1], points[2], points[3], points[4], points[5])
        elif segment_type == PathIterator.SEG_CLOSE:
            text_path.closeFigure()
        path_iterator.next()
    text_path.setFillMode(PathFillModeType.Normal)

    # Применить путь текста вместе с оригинальным путём геометрии.
    shape.setGeometryPaths([original_path, text_path])
finally:
    presentation.dispose()

example5_image

FAQ

Что происходит с заливкой и контурами после замены геометрии?
Стиль остаётся привязан к фигуре; меняется только контур. Заливка и контур автоматически применяются к новой геометрии.

Как правильно повернуть пользовательскую фигуру вместе с её геометрией?
Используйте метод setRotation фигуры; геометрия вращается вместе с фигурой, поскольку привязана к её собственной системе координат.

Можно ли преобразовать пользовательскую фигуру в изображение, чтобы «зафиксировать» результат?
Да. Экспортируйте нужный slide или саму shape в растровый формат; это упрощает дальнейшую работу с тяжёлой геометрией.

Управление коннекторами в презентациях на Python через Java Добавление эллипсов в презентации в Python через Java