自定义形状

使用编辑点更改形状

考虑一个正方形。在 PowerPoint 中，使用 编辑点，您可以

• 将正方形的角向内或向外移动
• 指定角落或点的曲率
• 向正方形添加新点
• 操作正方形上的点等。

本质上，您可以对任何形状执行上述任务。使用编辑点，您可以更改形状或从现有形状创建新形状。

形状编辑提示

在通过编辑点开始编辑 PowerPoint 形状之前，您可能想要考虑以下有关形状的几点：

• 形状（或其路径）可以是封闭的或开放的。
• 所有形状至少由 2 个相互连接的锚点组成。
• 一条线可以是直线或曲线。锚点决定线的性质。
• 锚点以角点、直点或平滑点的形式存在：
  • 角点是两条直线以某个角度连接的点。
  • 平滑点是两个手柄在一条直线上存在，并且线段以平滑的曲线连接。在这种情况下，所有手柄与锚点之间的距离相等。
  • 直点是两个手柄在一条直线上存在，并且该线的线段以平滑曲线连接。在这种情况下，手柄与锚点之间的距离不需要相等。
• 通过移动或编辑锚点（这会改变线的角度），您可以改变形状的外观。

要通过编辑点编辑 PowerPoint 形状，Aspose.Slides 提供了 GeometryPath 类和 IGeometryPath 接口。

• 一个 GeometryPath 实例表示 IGeometryShape 对象的几何路径。
• 要从 IGeometryShape 实例中检索 GeometryPath，您可以使用 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);

向形状添加自定义点

1. 创建 GeometryShape 类的实例并设置 ShapeType.Rectangle 类型。
2. 从形状中获取 GeometryPath 类的实例。
3. 在路径的两个顶部点之间添加新点。
4. 在路径的两个底部点之间添加新点。
5. 将路径应用到形状。

以下 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);
}

从形状中删除点

1. 创建 GeometryShape 类的实例并设置 ShapeType.Heart 类型。
2. 从形状中获取 GeometryPath 类的实例。
3. 删除路径的段。
4. 将路径应用到形状。

以下 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);
}

创建自定义形状

1. 计算形状的点。
2. 创建 GeometryPath 类的实例。
3. 用点填充路径。
4. 创建 GeometryShape 类的实例。
5. 将路径应用到形状。

以下 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);
}

创建复合自定义形状

1. 创建 GeometryShape 类的实例。
2. 创建第一个 GeometryPath 类的实例。
3. 创建第二个 GeometryPath 类的实例。
4. 将路径应用到形状。

以下 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});
}

创建具有圆角的自定义形状

以下 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);
}

检查形状几何是否封闭

检查 PowerPoint 演示文稿中的形状是否封闭对正确显示和编辑幻灯片上的对象至关重要。封闭形状被定义为其所有边连接在一起，形成一个没有间隙的单一边界。这样的形状可以是一个简单的几何形状或一个复杂的自定义轮廓。

形状的封闭性对于执行各种操作非常重要，例如填充颜色或渐变、应用效果和变换，以及确保与其他幻灯片元素的正确交互。

要检查形状的几何是否封闭，您需要执行以下操作：

1. 获取形状几何的访问权限。
2. 枚举形状中的几何路径。 2.1. 获取下一个路径的最后一个段。 2.2. 检查最后一个段是否为 CLOSE 命令。

以下代码示例演示了如何做到这一点：

if (shape is GeometryShape geometryShape)
{
    for (int i = 0; i < geometryShape.GetGeometryPaths().Length; i++)
    {
        IGeometryPath path = geometryShape.GetGeometryPaths()[i];

        if (path.PathData.Length == 0) continue;

        IPathSegment lastSegment = path.PathData[path.PathData.Length - 1];
        bool isClosed = lastSegment.PathCommand == PathCommandType.Close;

        Console.WriteLine($"路径 {i} 是封闭的: {isClosed}");
    }
}

将 GeometryPath 转换为 GraphicsPath (System.Drawing.Drawing2D)

1. 创建 GeometryShape 类的实例。
2. 创建 System.Drawing.Drawing2D 命名空间的 GraphicsPath 类的实例。
3. 使用 ShapeUtil 将 GraphicsPath 实例转换为 GeometryPath 实例。
4. 将路径应用到形状。

以下 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("文本在形状中", 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});
}