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

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

Рассмотрим квадрат. В 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

Часто задаваемые вопросы

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

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

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

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

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

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

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