Пользовательская форма

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

Рассмотрим квадрат. В PowerPoint с помощью точек редактирования вы можете

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

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

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

overview_image

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

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

Преобразование 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 = "Текст в форме";
    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

Соединитель Эллипс