在 Java 中自定义演示文稿形状

使用编辑点更改形状

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

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

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

形状编辑技巧

overview_image

在使用编辑点编辑 PowerPoint 形状之前，您可能需要考虑以下关于形状的要点：

形状（或其路径）可以是闭合的，也可以是开放的。
当形状闭合时，它没有起点或终点。形状开放时，则有起点和终点。
所有形状至少由 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();
}

判断形状几何是否闭合

闭合形状的定义是其所有边相连，形成无间隙的单一边界。此类形状可以是简单的几何形状，也可以是复杂的自定义轮廓。以下代码示例展示了如何检查形状几何是否闭合：

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 类的实例。
使用 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 = "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 本身导出为光栅格式；这可简化后续对复杂几何的处理。

使用 Java 管理演示文稿中的连接线在 Java 中向演示文稿添加椭圆