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

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

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

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

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

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

overview_image

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

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

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

Экземпляр GeometryPath представляет геометрический путь объекта IGeometryShape.
Чтобы получить GeometryPath из экземпляра IGeometryShape, используйте метод IGeometryShape.GetGeometryPaths.
Чтобы задать GeometryPath для фигуры, можно использовать методы: IGeometryShape.SetGeometryPath для сплошных фигур и IGeometryShape.SetGeometryPaths для композитных фигур.
Чтобы добавить отрезки, используйте методы из IGeometryPath.
С помощью свойств IGeometryPath.Stroke и IGeometryPath.FillMode можно задать внешний вид геометрического пути.
Через свойство IGeometryPath.PathData можно получить геометрический путь GeometryShape в виде массива сегментов пути.
Чтобы получить дополнительные параметры настройки геометрии фигуры, можно конвертировать GeometryPath в GraphicsPath.
Используйте методы GeometryPathToGraphicsPath и GraphicsPathToGeometryPath (из класса ShapeUtil) для преобразования GeometryPath в GraphicsPath и обратно.

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

Этот код на C# показывает, как

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

void LineTo(PointF point);
void LineTo(float x, float y);

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

void LineTo(PointF point, uint index);
void LineTo(float x, float y, uint index);

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

void CubicBezierTo(PointF point1, PointF point2, PointF point3);
void CubicBezierTo(float x1, float y1, float x2, float y2, float x3, float y3);

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

void CubicBezierTo(PointF point1, PointF point2, PointF point3, uint index);
void CubicBezierTo(float x1, float y1, float x2, float y2, float x3, float y3, uint index);

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

void QuadraticBezierTo(PointF point1, PointF point2);
void QuadraticBezierTo(float x1, float y1, float x2, float y2);

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

void QuadraticBezierTo(PointF point1, PointF point2, uint index);
void QuadraticBezierTo(float x1, float y1, float x2, float y2, uint index);

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

void ArcTo(float width, float heigth, float startAngle, float sweepAngle);

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

void CloseFigure();

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

void MoveTo(PointF point);
void MoveTo(float x, float y);

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

void RemoveAt(int index);

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

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

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

using (Presentation pres = new Presentation())
{
    GeometryShape shape = pres.Slides[0].Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 200, 100) as GeometryShape;
    IGeometryPath geometryPath = shape.GetGeometryPaths()[0];

    geometryPath.LineTo(100, 50, 1);
    geometryPath.LineTo(100, 50, 4);
    shape.SetGeometryPath(geometryPath);
}

example1_image

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

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

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

using (Presentation pres = new Presentation())
{
	GeometryShape shape = pres.Slides[0].Shapes.AddAutoShape(ShapeType.Heart, 100, 100, 300, 300) as GeometryShape;

	IGeometryPath path = shape.GetGeometryPaths()[0];
	path.RemoveAt(2);
	shape.SetGeometryPath(path);
}

example2_image

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

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

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

List<PointF> points = new List<PointF>();

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 PointF((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 PointF((float)x + R, (float)y + R));
}

GeometryPath starPath = new GeometryPath();
starPath.MoveTo(points[0]);

for (int i = 1; i < points.Count; i++)
{
    starPath.LineTo(points[i]);
}

starPath.CloseFigure();

using (Presentation pres = new Presentation())
{
    GeometryShape shape = pres.Slides[0].Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, R * 2, R * 2) as GeometryShape;

    shape.SetGeometryPath(starPath);
}

example3_image

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

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

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

using (Presentation pres = new Presentation())
{
    GeometryShape shape = pres.Slides[0].Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 200, 100) as GeometryShape;

    GeometryPath geometryPath0 = new GeometryPath();
    geometryPath0.MoveTo(0, 0);
    geometryPath0.LineTo(shape.Width, 0);
    geometryPath0.LineTo(shape.Width, shape.Height/3);
    geometryPath0.LineTo(0, shape.Height / 3);
    geometryPath0.CloseFigure();

    GeometryPath geometryPath1 = new GeometryPath();
    geometryPath1.MoveTo(0, shape.Height/3 * 2);
    geometryPath1.LineTo(shape.Width, shape.Height / 3 * 2);
    geometryPath1.LineTo(shape.Width, shape.Height);
    geometryPath1.LineTo(0, shape.Height);
    geometryPath1.CloseFigure();

    shape.SetGeometryPaths(new GeometryPath[] { geometryPath0, geometryPath1});
}

example4_image

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

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

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

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

using (var presentation = new Presentation())
{
    var childShape = presentation.Slides[0].Shapes.AddAutoShape(
        ShapeType.Custom, shapeX, shapeY, shapeWidth, shapeHeight);

    var geometryPath = new GeometryPath();

    var point1 = new PointF(leftTopSize, 0);
    var point2 = new PointF(shapeWidth - rightTopSize, 0);
    var point3 = new PointF(shapeWidth, shapeHeight - rightBottomSize);
    var point4 = new PointF(leftBottomSize, shapeHeight);
    var point5 = new PointF(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);

    presentation.Save("output.pptx", SaveFormat.Pptx);
}

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

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

bool IsGeometryClosed(IGeometryShape geometryShape)
{
    bool? isClosed = null;

    foreach (var geometryPath in geometryShape.GetGeometryPaths())
    {
        var dataLength = geometryPath.PathData.Length;
        if (dataLength == 0)
            continue;

        var lastSegment = geometryPath.PathData[dataLength - 1];
        isClosed = lastSegment.PathCommand == PathCommandType.Close;

        if (isClosed == false)
            return false;
    }
    
    return isClosed == true;
}

Преобразование GeometryPath в GraphicsPath (System.Drawing.Drawing2D)

Создайте экземпляр класса GeometryShape.
Создайте экземпляр класса GraphicsPath из пространства имён System.Drawing.Drawing2D.
Преобразуйте экземпляр GraphicsPath в экземпляр GeometryPath с помощью ShapeUtil.
Примените пути к фигуре.

Этот код на C# — реализация перечисленных шагов — демонстрирует процесс преобразования GeometryPath в GraphicsPath:

using (Presentation pres = new Presentation())
{
    GeometryShape shape = pres.Slides[0].Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 300, 100) as GeometryShape;

    IGeometryPath originalPath = shape.GetGeometryPaths()[0];
    originalPath.FillMode = PathFillModeType.None;

    GraphicsPath gPath = new GraphicsPath();

    gPath.AddString("Text in shape", new FontFamily("Arial"), 1, 40, new PointF(10, 10), StringFormat.GenericDefault);

    IGeometryPath textPath = ShapeUtil.GraphicsPathToGeometryPath(gPath);
    textPath.FillMode = PathFillModeType.Normal;

    shape.SetGeometryPaths(new[] {originalPath, textPath}) ;
}

example5_image

FAQ

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

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

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

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