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

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

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

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

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

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

overview_image

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

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

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

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

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

Этот Java‑код показывает, как

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

public void lineTo(java.awt.geom.Point2D.Float point);
public void lineTo(float x, float y);

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

public void lineTo(java.awt.geom.Point2D.Float point, long index);
public void lineTo(float x, float y, long index);

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

public void cubicBezierTo(java.awt.geom.Point2D.Float point1, java.awt.geom.Point2D.Float point2, java.awt.geom.Point2D.Float point3);
public void cubicBezierTo(float x1, float y1, float x2, float y2, float x3, float y3);

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

public void cubicBezierTo(java.awt.geom.Point2D.Float point1, java.awt.geom.Point2D.Float point2, java.awt.geom.Point2D.Float point3, long index);
public void cubicBezierTo(float x1, float y1, float x2, float y2, float x3, float y3, long index);

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

public void quadraticBezierTo(java.awt.geom.Point2D.Float point1, java.awt.geom.Point2D.Float point2);
public void quadraticBezierTo(float x1, float y1, float x2, float y2);

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

public void quadraticBezierTo(java.awt.geom.Point2D.Float point1, java.awt.geom.Point2D.Float point2, long index);
public void quadraticBezierTo(float x1, float y1, float x2, float y2, long index);

Присоединить заданную дугу к пути:

public void arcTo(float width, float heigth, float startAngle, float sweepAngle);

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

public void closeFigure();

Задать позицию следующей точки:

public void moveTo(java.awt.geom.Point2D.Float point);
public void moveTo(float x, float y);

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

public void removeAt(int index);

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

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

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

Presentation pres = new Presentation();
try {
    GeometryShape shape = (GeometryShape) pres.getSlides().get_Item(0).
            getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 200, 100);
    IGeometryPath geometryPath = shape.getGeometryPaths()[0];

    geometryPath.lineTo(100, 50, 1);
    geometryPath.lineTo(100, 50, 4);
    shape.setGeometryPath(geometryPath);
} finally {
    if (pres != null) pres.dispose();
}

example1_image

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

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

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

Presentation pres = new Presentation();
try {
    GeometryShape shape = (GeometryShape) pres.getSlides().get_Item(0).
            getShapes().addAutoShape(ShapeType.Heart, 100, 100, 300, 300);

    IGeometryPath path = shape.getGeometryPaths()[0];
    path.removeAt(2);
    shape.setGeometryPath(path);
} finally {
    if (pres != null) pres.dispose();
}

example2_image

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

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

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

List<Point2D.Float> points = new ArrayList<Point2D.Float>();

float R = 100, r = 50;
int step = 72;

for (int angle = -90; angle < 270; angle += step)
{
    double radians = angle * (Math.PI / 180f);
    double x = R * Math.cos(radians);
    double y = R * Math.sin(radians);
    points.add(new Point2D.Float((float)x + R, (float)y + R));

    radians = Math.PI * (angle + step / 2) / 180.0;
    x = r * Math.cos(radians);
    y = r * Math.sin(radians);
    points.add(new Point2D.Float((float)x + R, (float)y + R));
}

GeometryPath starPath = new GeometryPath();
starPath.moveTo(points.get(0));

for (int i = 1; i < points.size(); i++)
{
    starPath.lineTo(points.get(i));
}

starPath.closeFigure();

Presentation pres = new Presentation();
try {
    GeometryShape shape = (GeometryShape) pres.getSlides().get_Item(0).
            getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, R * 2, R * 2);

    shape.setGeometryPath(starPath);
} finally {
    if (pres != null) pres.dispose();
}

example3_image

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

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

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

Presentation pres = new Presentation();
try {
    GeometryShape shape = (GeometryShape) pres.getSlides().get_Item(0).
            getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 200, 100);

    GeometryPath geometryPath0 = new GeometryPath();
    geometryPath0.moveTo(0, 0);
    geometryPath0.lineTo(shape.getWidth(), 0);
    geometryPath0.lineTo(shape.getWidth(), shape.getHeight()/3);
    geometryPath0.lineTo(0, shape.getHeight() / 3);
    geometryPath0.closeFigure();

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

    shape.setGeometryPaths(new GeometryPath[] { geometryPath0, geometryPath1});
} finally {
    if (pres != null) pres.dispose();
}

example4_image

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

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

float shapeX = 20f;
float shapeY = 20f;
float shapeWidth = 300f;
float shapeHeight = 200f;

float leftTopSize = 50f;
float rightTopSize = 20f;
float rightBottomSize = 40f;
float leftBottomSize = 10f;

Presentation pres = new Presentation();
try {
    IAutoShape childShape = pres.getSlides().get_Item(0).getShapes().addAutoShape(
            ShapeType.Custom, shapeX, shapeY, shapeWidth, shapeHeight);

    GeometryPath geometryPath = new GeometryPath();

    Point2D.Float point1 = new Point2D.Float(leftTopSize, 0);
    Point2D.Float point2 = new Point2D.Float(shapeWidth - rightTopSize, 0);
    Point2D.Float point3 = new Point2D.Float(shapeWidth, shapeHeight - rightBottomSize);
    Point2D.Float point4 = new Point2D.Float(leftBottomSize, shapeHeight);
    Point2D.Float point5 = new Point2D.Float(0, leftTopSize);

    geometryPath.moveTo(point1);
    geometryPath.lineTo(point2);
    geometryPath.arcTo(rightTopSize, rightTopSize, 180, -90);
    geometryPath.lineTo(point3);
    geometryPath.arcTo(rightBottomSize, rightBottomSize, -90, -90);
    geometryPath.lineTo(point4);
    geometryPath.arcTo(leftBottomSize, leftBottomSize, 0, -90);
    geometryPath.lineTo(point5);
    geometryPath.arcTo(leftTopSize, leftTopSize, 90, -90);

    geometryPath.closeFigure();

    childShape.setGeometryPath(geometryPath);

    pres.save("output.pptx", SaveFormat.Pptx);
} finally {
    if (pres!= null) pres.dispose();
}

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

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

boolean isGeometryClosed(IGeometryShape geometryShape)
{
    Boolean isClosed = null;

    for (IGeometryPath geometryPath : geometryShape.getGeometryPaths()) {
        int dataLength = geometryPath.getPathData().length;
        if (dataLength == 0)
            continue;

        IPathSegment lastSegment = geometryPath.getPathData()[dataLength - 1];
        isClosed = lastSegment.getPathCommand() == PathCommandType.Close;

        if (isClosed == false)
            return false;
    }

    return isClosed == true;
}

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

Создайте экземпляр класса GeometryShape.
Создайте экземпляр класса java.awt.Shape.
Преобразуйте экземпляр java.awt.Shape в экземпляр GeometryPath с помощью ShapeUtil.
Примените пути к фигуре.

Этот Java‑код, реализующий описанные шаги, демонстрирует процесс преобразования GeometryPath в GraphicsPath:

Presentation pres = new Presentation();
try {
    // Создать новую фигуру
    GeometryShape shape = (GeometryShape)pres.getSlides().get_Item(0).
            getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 300, 100);

    // Получить геометрический путь фигуры
    IGeometryPath originalPath = shape.getGeometryPaths()[0];
    originalPath.setFillMode(PathFillModeType.None);

    // Создать новый графический путь с текстом
    Shape graphicsPath;
    Font font = new java.awt.Font("Arial", Font.PLAIN, 40);
    String text = "Text in shape";
    BufferedImage img = new BufferedImage(100, 100, BufferedImage.TYPE_INT_ARGB);
    Graphics2D g2 = img.createGraphics();

    try
    {
        GlyphVector glyphVector = font.createGlyphVector(g2.getFontRenderContext(), text);
        graphicsPath = glyphVector.getOutline(20f, ((float) -glyphVector.getVisualBounds().getY()) + 10);
    }
    finally {
        g2.dispose();
    }

    // Преобразовать графический путь в геометрический путь
    IGeometryPath textPath = ShapeUtil.graphicsPathToGeometryPath(graphicsPath);
    textPath.setFillMode(PathFillModeType.Normal);

    // Установить комбинацию нового геометрического пути и исходного геометрического пути для фигуры
    shape.setGeometryPaths(new IGeometryPath[] { originalPath, textPath });
} finally {
    if (pres != null) pres.dispose();
}

example5_image

FAQ

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

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

Как корректно повернуть пользовательскую фигуру вместе с её геометрией?

Вызовите метод фигуры setRotation; геометрия будет повёрнута вместе с фигурой, так как она привязана к её собственной системе координат.

Можно ли преобразовать пользовательскую фигуру в изображение, чтобы «зафиксировать» результат?

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

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