Präsentationsformen in Java anpassen

Eine Form mit Editierpunkten ändern

Betrachten Sie ein Quadrat. In PowerPoint können Sie mit Editierpunkten

die Ecke des Quadrats nach innen oder außen verschieben
die Krümmung einer Ecke oder eines Punktes festlegen
neue Punkte zum Quadrat hinzufügen
Punkte am Quadrat manipulieren usw.

Im Wesentlichen können Sie die beschriebenen Vorgänge an jeder Form ausführen. Mit Editierpunkten können Sie eine Form ändern oder aus einer vorhandenen Form eine neue Form erstellen.

Tipps zum Formen‑Editieren

overview_image

Bevor Sie beginnen, PowerPoint‑Formen über Editierpunkte zu bearbeiten, sollten Sie diese Punkte zu Formen beachten:

Eine Form (oder ihr Pfad) kann entweder geschlossen oder offen sein.
Wenn eine Form geschlossen ist, fehlt ein Anfangs‑ oder Endpunkt. Wenn eine Form offen ist, hat sie einen Anfang und ein Ende.
Alle Formen bestehen aus mindestens 2 Ankerpunkten, die durch Linien miteinander verbunden sind
Eine Linie ist entweder gerade oder gekrümmt. Ankerpunkte bestimmen die Art der Linie.
Ankerpunkte existieren als Eckpunkte, Gerade‑Punkte oder Glatte‑Punkte:
- Ein Eckpunkt ist ein Punkt, an dem 2 gerade Linien in einem Winkel zusammentreffen.
- Ein glatter Punkt ist ein Punkt, an dem 2 Griff‑Handles in einer Geraden liegen und die Liniensegmente in einer weichen Kurve zusammenlaufen. In diesem Fall sind alle Griff‑Handles vom Ankerpunkt gleichweit entfernt.
- Ein gerader Punkt ist ein Punkt, an dem 2 Griff‑Handles in einer Geraden liegen und die Liniensegmente in einer weichen Kurve zusammenlaufen. In diesem Fall müssen die Griff‑Handles nicht gleichweit vom Ankerpunkt entfernt sein.
Durch das Verschieben oder Editieren von Ankerpunkten (was den Winkel der Linien ändert) können Sie das Aussehen einer Form verändern.

Um PowerPoint‑Formen über Editierpunkte zu bearbeiten, stellt Aspose.Slides die Klasse GeometryPath und das Interface IGeometryPath bereit.

Eine GeometryPath-Instanz repräsentiert einen Geometrie‑Pfad des IGeometryShape-Objekts.
Um den GeometryPath aus der IGeometryShape‑Instanz zu erhalten, können Sie die Methode IGeometryShape.getGeometryPaths verwenden.
Um den GeometryPath für eine Form zu setzen, können Sie diese Methoden verwenden: IGeometryShape.setGeometryPath für solide Formen und IGeometryShape.setGeometryPaths für zusammengesetzte Formen.
Um Segmente hinzuzufügen, können Sie die Methoden unter IGeometryPath nutzen.
Mit den Methoden IGeometryPath.setStroke und IGeometryPath.setFillMode können Sie das Erscheinungsbild eines Geometrie‑Pfads festlegen.
Über die Methode IGeometryPath.getPathData können Sie den Geometrie‑Pfad einer GeometryShape als Array von Pfadsegmenten abrufen.
Um weitere Optionen zur Anpassung der Formgeometrie zu nutzen, können Sie GeometryPath in java.awt.Shape konvertieren.
Verwenden Sie die Methoden geometryPathToGraphicsPath und graphicsPathToGeometryPath (aus der Klasse ShapeUtil), um GeometryPath in java.awt.Shape und zurück zu konvertieren.

Einfache Editier‑Operationen

Dieser Java‑Code zeigt, wie man

Eine Linie an das Ende eines Pfads anhängt

public void lineTo(java.awt.geom.Point2D.Float point);
public void lineTo(float x, float y);

Eine Linie an einer bestimmten Position eines Pfads hinzufügt:

public void lineTo(java.awt.geom.Point2D.Float point, long index);
public void lineTo(float x, float y, long index);

Eine kubische Bezier‑Kurve am Ende eines Pfads hinzufügt:

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);

Eine kubische Bezier‑Kurve an einer angegebenen Position eines Pfads hinzufügt:

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);

Eine quadratische Bezier‑Kurve am Ende eines Pfads hinzufügt:

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);

Eine quadratische Bezier‑Kurve an einer angegebenen Position eines Pfads hinzufügt:

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);

Einen gegebenen Bogen an einen Pfad anhängt:

public void arcTo(float width, float heigth, float startAngle, float sweepAngle);

Die aktuelle Figur eines Pfads schließt:

public void closeFigure();

Die Position für den nächsten Punkt festlegt:

public void moveTo(java.awt.geom.Point2D.Float point);
public void moveTo(float x, float y);

Das Pfadsegment an einem angegebenen Index entfernt:

public void removeAt(int index);

Benutzerdefinierte Punkte zu einer Form hinzufügen

Erstellen Sie eine Instanz der Klasse GeometryShape und setzen Sie den Typ ShapeType.Rectangle.
Holen Sie sich eine Instanz der Klasse GeometryPath aus der Form.
Fügen Sie einen neuen Punkt zwischen den beiden oberen Punkten des Pfads hinzu.
Fügen Sie einen neuen Punkt zwischen den beiden unteren Punkten des Pfads hinzu.
Wenden Sie den Pfad auf die Form an.

Dieser Java‑Code zeigt, wie man benutzerdefinierte Punkte zu einer Form hinzufügt:

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

Punkte aus einer Form entfernen

Erstellen Sie eine Instanz der Klasse GeometryShape und setzen Sie den Typ ShapeType.Heart.
Holen Sie sich eine Instanz der Klasse GeometryPath aus der Form.
Entfernen Sie das Segment des Pfads.
Wenden Sie den Pfad auf die Form an.

Dieser Java‑Code zeigt, wie man Punkte aus einer Form entfernt:

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

Eine benutzerdefinierte Form erstellen

Berechnen Sie die Punkte für die Form.
Erstellen Sie eine Instanz der Klasse GeometryPath.
Füllen Sie den Pfad mit den Punkten.
Erstellen Sie eine Instanz der Klasse GeometryShape.
Wenden Sie den Pfad auf die Form an.

Dieser Java‑Code zeigt, wie man eine benutzerdefinierte Form erstellt:

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

Ein zusammengesetztes benutzerdefiniertes Formobjekt erstellen

Erstellen Sie eine Instanz der Klasse GeometryShape.
Erstellen Sie eine erste Instanz der Klasse GeometryPath.
Erstellen Sie eine zweite Instanz der Klasse GeometryPath.
Wenden Sie die Pfade auf die Form an.

Dieser Java‑Code zeigt, wie man ein zusammengesetztes benutzerdefiniertes Formobjekt erstellt:

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

Eine benutzerdefinierte Form mit gekrümmten Ecken erstellen

Dieser Java‑Code zeigt, wie man eine benutzerdefinierte Form mit gekrümmten Ecken (nach innen) erstellt:

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();
}

Ermitteln, ob eine Formgeometrie geschlossen ist

Eine geschlossene Form wird definiert als eine, bei der alle Seiten miteinander verbunden sind und eine einzige Grenze ohne Lücken bilden. Eine solche Form kann eine einfache geometrische Form oder ein komplexes benutzerdefiniertes Kontur sein. Das folgende Code‑Beispiel zeigt, wie man prüft, ob eine Formgeometrie geschlossen ist:

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 in java.awt.Shape konvertieren

Erstellen Sie eine Instanz der Klasse GeometryShape.
Erstellen Sie eine Instanz der Klasse java.awt.Shape.
Konvertieren Sie die java.awt.Shape-Instanz mithilfe von ShapeUtil in eine GeometryPath-Instanz.
Wenden Sie die Pfade auf die Form an.

Dieser Java‑Code – eine Umsetzung der obigen Schritte – demonstriert den GeometryPath‑zu‑GraphicsPath‑Konvertierungsprozess:

Presentation pres = new Presentation();
try {
    // Neue Form erstellen
    GeometryShape shape = (GeometryShape)pres.getSlides().get_Item(0).
            getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 300, 100);

    // Geometriepfad der Form abrufen
    IGeometryPath originalPath = shape.getGeometryPaths()[0];
    originalPath.setFillMode(PathFillModeType.None);

    // Neuen Grafikpfad mit Text erstellen
    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();
    }

    // Grafikpfad in Geometriepfad konvertieren
    IGeometryPath textPath = ShapeUtil.graphicsPathToGeometryPath(graphicsPath);
    textPath.setFillMode(PathFillModeType.Normal);

    // Kombination aus neuem Geometriepfad und ursprünglichem Geometriepfad zur Form hinzufügen
    shape.setGeometryPaths(new IGeometryPath[] { originalPath, textPath });
} finally {
    if (pres != null) pres.dispose();
}

example5_image

FAQ

Was passiert mit Füllung und Kontur, wenn die Geometrie ersetzt wird?

Der Stil bleibt bei der Form; nur die Kontur ändert sich. Füllung und Kontur werden automatisch auf die neue Geometrie angewendet.

Wie drehe ich eine benutzerdefinierte Form korrekt zusammen mit ihrer Geometrie?

Verwenden Sie die Methode setRotation der Form; die Geometrie rotiert mit der Form, weil sie an das Koordinatensystem der Form gebunden ist.

Kann ich eine benutzerdefinierte Form in ein Bild konvertieren, um das Ergebnis „einzusperren“?

Ja. Exportieren Sie den gewünschten slide-Bereich oder die shape-Selbst in ein Rasterformat; das vereinfacht die weitere Arbeit mit aufwendigen Geometrien.

Verwalten von Verbindern in Präsentationen mit Java Ellipsen zu Präsentationen in Java hinzufügen