Пользовательская Фигура

Изменение Фигуры С Использованием Точек Редактирования

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

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

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

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

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

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

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

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

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

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

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

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

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

void LineTo(PointF point, uint32_t index);
void LineTo(float x, float y, uint32_t 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, uint32_t index);
void CubicBezierTo(float x1, float y1, float x2, float y2, float x3, float y3, uint32_t index);

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

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

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

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

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

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

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

void CloseFigure();

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

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

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

void RemoveAt(int32_t index);

Добавление Пользовательских Точек к Фигуре

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

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

SharedPtr<Presentation> pres = System::MakeObject<Presentation>();

SharedPtr<IShapeCollection> shapes = pres->get_Slides()->idx_get(0)->get_Shapes();
SharedPtr<GeometryShape> shape = System::ExplicitCast<GeometryShape>(shapes->AddAutoShape(ShapeType::Rectangle, 100.0f, 100.0f, 200.0f, 100.0f));

SharedPtr<IGeometryPath> geometryPath = shape->GetGeometryPaths()->idx_get(0);

geometryPath->LineTo(100.0f, 50.0f, 1);
geometryPath->LineTo(100.0f, 50.0f, 4);
shape->SetGeometryPath(geometryPath);

Удаление Точек Из Фигуры

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

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

SharedPtr<Presentation> pres = System::MakeObject<Presentation>();

SharedPtr<IShapeCollection> shapes = pres->get_Slides()->idx_get(0)->get_Shapes();
SharedPtr<GeometryShape> shape = System::ExplicitCast<GeometryShape>(shapes->AddAutoShape(ShapeType::Heart, 100.0f, 100.0f, 300.0f, 300.0f));

SharedPtr<IGeometryPath> path = shape->GetGeometryPaths()->idx_get(0);
path->RemoveAt(2);
shape->SetGeometryPath(path);

Создание Пользовательской Формы

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

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

SharedPtr<List<PointF>> points = System::MakeObject<List<PointF>>();

float R = 100.0f, r = 50.0f;
int32_t step = 72;

for (int32_t angle = -90; angle < 270; angle += step)
{
    double radians = angle * (Math::PI / 180.f);
    double x = outerRadius * Math::Cos(radians);
    double y = outerRadius * Math::Sin(radians);
    points->Add(PointF((float)x + outerRadius, (float)y + outerRadius));

    radians = Math::PI * (angle + step / 2) / 180.0;
    x = innerRadiusr * Math::Cos(radians);
    y = innerRadiusr * Math::Sin(radians);
    points->Add(PointF((float)x + outerRadius, (float)y + outerRadius));
}

SharedPtr<GeometryPath> starPath = System::MakeObject<GeometryPath>();
starPath->MoveTo(points->idx_get(0));

for (int32_t i = 1; i < points->get_Count(); i++)
{
    starPath->LineTo(points->idx_get(i));
}

starPath->CloseFigure();

SharedPtr<Presentation> pres = System::MakeObject<Presentation>();

SharedPtr<IShapeCollection> shapes = pres->get_Slides()->idx_get(0)->get_Shapes();
SharedPtr<GeometryShape> shape = System::ExplicitCast<GeometryShape>(shapes->AddAutoShape(ShapeType::Rectangle, 100.0f, 100.0f, R * 2, R * 2));

shape->SetGeometryPath(starPath);

Создание Составной Пользовательской Формы

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

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

SharedPtr<Presentation> pres = System::MakeObject<Presentation>();

SharedPtr<IShapeCollection> shapes = pres->get_Slides()->idx_get(0)->get_Shapes();
SharedPtr<GeometryShape> shape = System::ExplicitCast<GeometryShape>(shapes->AddAutoShape(ShapeType::Rectangle, 100.0f, 100.0f, 200.0f, 100.0f));

SharedPtr<IGeometryPath> geometryPath0 = System::MakeObject<GeometryPath>();
geometryPath0->MoveTo(0.0f, 0.0f);
geometryPath0->LineTo(shape->get_Width(), 0.0f);
geometryPath0->LineTo(shape->get_Width(), shape->get_Height() / 3);
geometryPath0->LineTo(0.0f, shape->get_Height() / 3);
geometryPath0->CloseFigure();

SharedPtr<IGeometryPath> geometryPath1 = System::MakeObject<GeometryPath>();
geometryPath1->MoveTo(0.0f, shape->get_Height() / 3 * 2);
geometryPath1->LineTo(shape->get_Width(), shape->get_Height() / 3 * 2);
geometryPath1->LineTo(shape->get_Width(), shape->get_Height());
geometryPath1->LineTo(0.0f, shape->get_Height());
geometryPath1->CloseFigure();

shape->SetGeometryPaths(System::MakeArray<SharedPtr<IGeometryPath>>({ geometryPath0, geometryPath1 }));

Создание Пользовательской Формы С Закругленными Углами

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

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

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

auto presentation = System::MakeObject<Presentation>();

auto childShape = presentation->get_Slides()->idx_get(0)->get_Shapes()->AddAutoShape(ShapeType::Custom, shapeX, shapeY, shapeWidth, shapeHeight);

auto geometryPath = System::MakeObject<GeometryPath>();

PointF point1(leftTopSize, 0.0f);
PointF point2(shapeWidth - rightTopSize, 0.0f);
PointF point3(shapeWidth, shapeHeight - rightBottomSize);
PointF point4(leftBottomSize, shapeHeight);
PointF point5(0.0f, leftTopSize);

geometryPath->MoveTo(point1);
geometryPath->LineTo(point2);
geometryPath->ArcTo(rightTopSize, rightTopSize, 180.0f, -90.0f);
geometryPath->LineTo(point3);
geometryPath->ArcTo(rightBottomSize, rightBottomSize, -90.0f, -90.0f);
geometryPath->LineTo(point4);
geometryPath->ArcTo(leftBottomSize, leftBottomSize, 0.0f, -90.0f);
geometryPath->LineTo(point5);
geometryPath->ArcTo(leftTopSize, leftTopSize, 90.0f, -90.0f);

geometryPath->CloseFigure();

childShape->SetGeometryPath(geometryPath);

presentation->Save(u"output.pptx", SaveFormat::Pptx);

Преобразование GeometryPath в GraphicsPath

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

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

SharedPtr<Presentation> pres = System::MakeObject<Presentation>();

SharedPtr<IShapeCollection> shapes = pres->get_Slides()->idx_get(0)->get_Shapes();
SharedPtr<GeometryShape> shape = System::ExplicitCast<GeometryShape>(shapes->AddAutoShape(ShapeType::Rectangle, 100.0f, 100.0f, 300.0f, 100.0f));

SharedPtr<IGeometryPath> originalPath = shape->GetGeometryPaths()->idx_get(0);
originalPath->set_FillMode(PathFillModeType::None);

SharedPtr<Drawing2D::GraphicsPath> graphicsPath = System::MakeObject<Drawing2D::GraphicsPath>();
graphicsPath->AddString(u"Текст в фигуре", System::MakeObject<FontFamily>(u"Arial"), 1, 40.0f, PointF(10.0f, 10.0f), StringFormat::get_GenericDefault());

SharedPtr<IGeometryPath> textPath = ShapeUtil::GraphicsPathToGeometryPath(graphicsPath);
textPath->set_FillMode(PathFillModeType::Normal);

shape->SetGeometryPaths(System::MakeArray<SharedPtr<IGeometryPath>>({ originalPath, textPath }));