Präsentationsformen in PHP anpassen

Form mit Bearbeitungspunkten ändern

Betrachten Sie ein Quadrat. In PowerPoint können Sie mithilfe von Bearbeitungspunkten

• 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 für jede Form ausführen. Mit Bearbeitungspunkten können Sie eine Form ändern oder aus einer vorhandenen Form eine neue Form erstellen.

Tipps zur Formbearbeitung

Bevor Sie beginnen, PowerPoint‑Formen über Bearbeitungspunkte zu bearbeiten, sollten Sie diese Punkte zu Formen berücksichtigen:

• Eine Form (oder ihr Pfad) kann entweder geschlossen oder offen sein.
• Ist eine Form geschlossen, fehlt ein Anfangs‑ oder Endpunkt. Ist eine Form offen, 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 kurvig. Ankerpunkte bestimmen die Art der Linie.
• Ankerpunkte existieren als Eckpunkte, gerade Punkte oder glatte Punkte:
  • Ein Eckpunkt ist ein Punkt, an dem sich 2 gerade Linien unter einem Winkel treffen.
  • Ein glatter Punkt ist ein Punkt, an dem 2 Griffe in einer geraden Linie liegen und die Liniensegmente zu einer sanften Kurve verbunden werden. In diesem Fall sind alle Griffe in gleichem Abstand vom Ankerpunkt getrennt.
  • Ein gerader Punkt ist ein Punkt, an dem 2 Griffe in einer geraden Linie liegen und die Liniensegmente zu einer sanften Kurve verbunden werden. In diesem Fall müssen die Griffe nicht in gleichem Abstand vom Ankerpunkt getrennt sein.
• Durch das Verschieben oder Bearbeiten von Ankerpunkten (was den Winkel der Linien ändert) können Sie das Aussehen einer Form verändern.

Um PowerPoint‑Formen über Bearbeitungspunkte zu bearbeiten, stellt Aspose.Slides die Klasse GeometryPath bereit.

• Eine GeometryPath‑Instanz stellt den Geometrie‑Pfad des Objekts GeometryShape dar.
• Um den GeometryPath aus der GeometryShape‑Instanz abzurufen, können Sie die Methode GeometryShape::getGeometryPaths verwenden.
• Um den GeometryPath für eine Form festzulegen, können Sie diese Methoden verwenden: GeometryShape::setGeometryPath für solide Formen und GeometryShape::setGeometryPaths für komposite Formen.
• Um Segmente hinzuzufügen, können Sie die Methoden unter GeometryPath verwenden.
• Mit den Methoden GeometryPath::setStroke und GeometryPath::setFillMode können Sie das Aussehen eines Geometrie‑Pfads festlegen.
• Mit der Methode GeometryPath::getPathData können Sie den Geometrie‑Pfad eines 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 hin‑und her zu konvertieren.

Einfache Bearbeitungsoperationen

Dieser PHP‑Code zeigt Ihnen, wie Sie

Eine Linie am Ende eines Pfads hinzufügen

Eine Linie an einer angegebenen Position im Pfad hinzufügen:

Eine kubische Bézier‑Kurve am Ende eines Pfads hinzufügen:

Eine kubische Bézier‑Kurve an der angegebenen Position im Pfad hinzufügen:

Eine quadratische Bézier‑Kurve am Ende eines Pfads hinzufügen:

Eine quadratische Bézier‑Kurve an der angegebenen Position im Pfad hinzufügen:

Einen angegebenen Bogen an einen Pfad anhängen:

Die aktuelle Figur eines Pfads schließen:

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

Das Pfadsegment an einem angegebenen Index entfernen:

Benutzerdefinierte Punkte zu einer Form hinzufügen

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

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

  $pres = new Presentation();
  try {
    $shape = $pres->getSlides()->get_Item(0)->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 100, 200, 100);
    $geometryPath = $shape->getGeometryPaths()[0];
    $geometryPath->lineTo(100, 50, 1);
    $geometryPath->lineTo(100, 50, 4);
    $shape->setGeometryPath($geometryPath);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Punkte aus einer Form entfernen

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

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

  $pres = new Presentation();
  try {
    $shape = $pres->getSlides()->get_Item(0)->getShapes()->addAutoShape(ShapeType::Heart, 100, 100, 300, 300);
    $path = $shape->getGeometryPaths()[0];
    $path->removeAt(2);
    $shape->setGeometryPath($path);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Eine benutzerdefinierte Form erstellen

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

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

  $points = new Java("java.util.ArrayList");
  $R = 100;
  $r = 50;
  $step = 72;
  for($angle = -90; $angle < 270; $angle += $step) {
    $radians = $angle * java("java.lang.Math")->PI / 180.0;
    $x = $R * java("java.lang.Math")->cos($radians);
    $y = $R * java("java.lang.Math")->sin($radians);
    $points->add(new Point2DFloat($x + $R, $y + $R));
    $radians = java("java.lang.Math")->PI * $angle . $step / 2 / 180.0;
    $x = $r * java("java.lang.Math")->cos($radians);
    $y = $r * java("java.lang.Math")->sin($radians);
    $points->add(new Point2DFloat($x + $R, $y + $R));
  }
  $starPath = new GeometryPath();
  $starPath->moveTo($points->get(0));
  for($i = 1; $i < java_values($points->size()) ; $i++) {
    $starPath->lineTo($points->get($i));
  }
  $starPath->closeFigure();
  $pres = new Presentation();
  try {
    $shape = $pres->getSlides()->get_Item(0)->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 100, $R * 2, $R * 2);
    $shape->setGeometryPath($starPath);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Eine zusammengesetzte benutzerdefinierte Form erstellen

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

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

  $pres = new Presentation();
  try {
    $shape = $pres->getSlides()->get_Item(0)->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 100, 200, 100);
    $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();
    $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(array($geometryPath0, $geometryPath1 ));
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Eine benutzerdefinierte Form mit abgerundeten Ecken erstellen

Dieser PHP‑Code zeigt, wie man eine benutzerdefinierte Form mit nach innen gerichteten abgerundeten Ecken erstellt;

  $shapeX = 20.0;
  $shapeY = 20.0;
  $shapeWidth = 300.0;
  $shapeHeight = 200.0;
  $leftTopSize = 50.0;
  $rightTopSize = 20.0;
  $rightBottomSize = 40.0;
  $leftBottomSize = 10.0;
  $pres = new Presentation();
  try {
    $childShape = $pres->getSlides()->get_Item(0)->getShapes()->addAutoShape(ShapeType::Custom, $shapeX, $shapeY, $shapeWidth, $shapeHeight);
    $geometryPath = new GeometryPath();
    $point1 = new Point2DFloat($leftTopSize, 0);
    $point2 = new Point2DFloat($shapeWidth - $rightTopSize, 0);
    $point3 = new Point2DFloat($shapeWidth, $shapeHeight - $rightBottomSize);
    $point4 = new Point2DFloat($leftBottomSize, $shapeHeight);
    $point5 = new Point2DFloat(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 (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Ermitteln, ob eine Formgeometrie geschlossen ist

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

function isGeometryClosed($geometryShape)
{
    $isClosed = null;

    foreach ($geometryShape->getGeometryPaths() as $geometryPath) {
        $dataLength = count(java_values($geometryPath->getPathData()));
        if ($dataLength === 0) {
            continue;
        }

        $lastSegment = java_values($geometryPath->getPathData())[$dataLength - 1];
        $isClosed = $lastSegment->getPathCommand() === PathCommandType::Close;

        if ($isClosed === false) {
            return false;
        }
    }

    return $isClosed === true;
}

GeometryPath in java.awt.Shape konvertieren

1. Erstellen Sie eine Instanz der Klasse GeometryShape.
2. Erstellen Sie eine Instanz der Klasse java.awt.Shape.
3. Konvertieren Sie die [java.awt.Shape]‑Instanz mithilfe von ShapeUtil in die [GeometryPath]‑Instanz.
4. Wenden Sie die Pfade auf die Form an.

Dieser PHP‑Code – eine Umsetzung der oben genannten Schritte – demonstriert den Konvertierungsprozess von GeometryPath zu GraphicsPath:

  $pres = new Presentation();
  try {
    # Neue Form erstellen
    $shape = $pres->getSlides()->get_Item(0)->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 100, 300, 100);
    # Geometriepfad der Form holen
    $originalPath = $shape->getGeometryPaths()[0];
    $originalPath->setFillMode(PathFillModeType::None);
    # Neuen Grafikpfad mit Text erstellen
    $graphicsPath;
    $font = new Font("Arial", Font->PLAIN, 40);
    $text = "Text in shape";
    $img = new BufferedImage(100, 100, BufferedImage->TYPE_INT_ARGB);
    $g2 = $img->createGraphics();
    try {
      $glyphVector = $font->createGlyphVector($g2->getFontRenderContext(), $text);
      $graphicsPath = $glyphVector->getOutline(20.0, -$glyphVector->getVisualBounds()->getY() + 10);
    } finally {
      $g2->dispose();
    }
    # Grafikpfad in Geometriepfad konvertieren
    $textPath = ShapeUtil->graphicsPathToGeometryPath($graphicsPath);
    $textPath->setFillMode(PathFillModeType::Normal);
    # Kombination aus neuem Geometriepfad und originalem Geometriepfad für die Form festlegen
    $shape->setGeometryPaths(array($originalPath, $textPath ));
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

FAQ

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

Der Stil bleibt bei der Form erhalten; 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 eigene Koordinatensystem der Form gebunden ist.

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

Ja. Exportieren Sie den erforderlichen Folie-Bereich oder die Form selbst in ein Rasterformat; das vereinfacht die weitere Arbeit mit komplexen Geometrien.