自定义形状

使用编辑点更改形状

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

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

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

形状编辑技巧

overview_image

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

形状（或其路径）可以是封闭的或开放的。
当形状是封闭时，它没有起始或结束点。当形状是开放时，它有开始和结束。
所有形状至少由 2 个锚点通过线链接在一起。
线可以是直的或弯曲的。锚点决定线的性质。
锚点存在于角点、直点或平滑点：
- 角点是 2 条直线相交形成角度的点。
- 平滑点是 2 个手柄在一条直线上存在，并且线段以平滑曲线相交。在这种情况下，所有手柄与锚点之间距离相等。
- 直点是 2 个手柄在一条直线上存在，并且该线段以平滑曲线相交。在这种情况下，手柄不一定与锚点之间的距离相等。
通过移动或编辑锚点（这会改变线的角度），您可以改变形状的外观。

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

一个 GeometryPath 实例表示 IGeometryShape 对象的几何路径。
要从 IGeometryShape 实例检索 GeometryPath，您可以使用 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 类的实例。
使用 ShapeUtil 将 java.awt.Shape 实例转换为 GeometryPath 实例。
将路径应用于形状。

以下 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

连接器椭圆