Formenanimationen in Präsentationen mit PHP anwenden

Animationen sind visuelle Effekte, die auf Texte, Bilder, Formen oder Diagramme angewendet werden können. Sie verleihen Präsentationen oder deren Bestandteilen Leben.

Warum Animationen in Präsentationen verwenden?

Mit Animationen können Sie

den Informationsfluss steuern
wichtige Punkte hervorheben
das Interesse oder die Beteiligung Ihres Publikums erhöhen
Inhalte leichter lesbar, verdaulich oder verarbeitbar machen
die Aufmerksamkeit Ihrer Leser oder Zuschauer auf wichtige Teile einer Präsentation lenken

PowerPoint bietet zahlreiche Optionen und Werkzeuge für Animationen und Animationseffekte in den Kategorien Eingang, Ausgang, Betonung und Bewegungspfade.

Animationen in Aspose.Slides

Aspose.Slides stellt die Klassen und Typen bereit, die Sie benötigen, um mit Animationen im Namespace Aspose.Slides.Animation zu arbeiten,
Aspose.Slides bietet über 150 Animationseffekte im Aufzählungstyp EffectType. Diese Effekte entsprechen im Wesentlichen denselben (oder äquivalenten) Effekten, die in PowerPoint verwendet werden.

Animation auf ein Textfeld anwenden

Aspose.Slides for PHP via Java ermöglicht es Ihnen, Animationen auf den Text in einer Form anzuwenden.

Erstellen Sie eine Instanz der Presentation-Klasse.
Holen Sie sich eine Folienreferenz über deren Index.
Fügen Sie eine rectangle IAutoShape hinzu.
Fügen Sie Text zu IAutoShape.TextFrame hinzu.
Erhalten Sie die Hauptsequenz der Effekte.
Fügen Sie einen Animationseffekt zu IAutoShape hinzu.
Setzen Sie die Eigenschaft TextAnimation.BuildType auf den Wert aus der Aufzählung BuildType.
Schreiben Sie die Präsentation als PPTX-Datei auf die Festplatte.

Dieser PHP‑Code zeigt, wie Sie den Fade‑Effekt auf eine AutoShape anwenden und die Textanimation auf den Wert By 1st Level Paragraphs setzen:

  # Instanziert eine Präsentationsklasse, die eine Präsentationsdatei darstellt.
  $pres = new Presentation();
  try {
    $sld = $pres->getSlides()->get_Item(0);
    # Fügt ein neues AutoShape mit Text hinzu
    $autoShape = $sld->getShapes()->addAutoShape(ShapeType::Rectangle, 20, 20, 150, 100);
    $textFrame = $autoShape->getTextFrame();
    $textFrame->setText("First paragraph \nSecond paragraph \n Third paragraph");
    # Holt die Hauptsequenz der Folie.
    $sequence = $sld->getTimeline()->getMainSequence();
    # Fügt dem Shape den Fade-Animationseffekt hinzu
    $effect = $sequence->addEffect($autoShape, EffectType::Fade, EffectSubType::None, EffectTriggerType::OnClick);
    # Animiert den Shape-Text nach Absätzen der ersten Ebene
    $effect->getTextAnimation()->setBuildType(BuildType::ByLevelParagraphs1);
    # Sichert die PPTX-Datei auf dem Datenträger
    $pres->save($path . "AnimText_out.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Neben der Anwendung von Animationen auf Text können Sie auch Animationen auf ein einzelnes Paragraph anwenden. Siehe Animierter Text.

Animation auf ein PictureFrame anwenden

Erstellen Sie eine Instanz der Presentation-Klasse.
Holen Sie sich eine Folienreferenz über deren Index.
Fügen Sie ein PictureFrame zur Folie hinzu oder holen Sie es ab.
Erhalten Sie die Hauptsequenz der Effekte.
Fügen Sie einen Animationseffekt zu PictureFrame hinzu.
Schreiben Sie die Präsentation als PPTX-Datei auf die Festplatte.

Dieser PHP‑Code zeigt, wie Sie den Fly‑Effekt auf ein Bildrahmen anwenden:

  # Instanziert eine Präsentationsklasse, die eine Präsentationsdatei repräsentiert.
  $pres = new Presentation();
  try {
    # Lädt ein Bild, das zur Bildsammlung der Präsentation hinzugefügt wird
    $picture;
    $image = Images->fromFile("aspose-logo.jpg");
    try {
      $picture = $pres->getImages()->addImage($image);
    } finally {
      if (!java_is_null($image)) {
        $image->dispose();
      }
    }
    # Fügt Bildrahmen zur Folie hinzu
    $picFrame = $pres->getSlides()->get_Item(0)->getShapes()->addPictureFrame(ShapeType::Rectangle, 50, 50, 100, 100, $picture);
    # Holt die Hauptsequenz der Folie.
    $sequence = $pres->getSlides()->get_Item(0)->getTimeline()->getMainSequence();
    # Fügt dem Bildrahmen den Fly‑von‑links‑Animationseffekt hinzu
    $effect = $sequence->addEffect($picFrame, EffectType::Fly, EffectSubType::Left, EffectTriggerType::OnClick);
    # Speichert die PPTX-Datei auf dem Datenträger
    $pres->save($path . "AnimImage_out.pptx", SaveFormat::Pptx);
  } catch (JavaException $e) {
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Animation auf eine Form anwenden

Erstellen Sie eine Instanz der Presentation-Klasse.
Holen Sie sich eine Folienreferenz über deren Index.
Fügen Sie eine rectangle IAutoShape hinzu.
Fügen Sie eine Bevel IAutoShape hinzu (wenn dieses Objekt angeklickt wird, wird die Animation abgespielt).
Erstellen Sie eine Sequenz von Effekten für die Keilform.
Erstellen Sie einen benutzerdefinierten UserPath.
Fügen Sie Befehle zum Bewegen zum UserPath hinzu.
Schreiben Sie die Präsentation als PPTX-Datei auf die Festplatte.

Dieser PHP‑Code zeigt, wie Sie den PathFootball‑Effekt auf eine Form anwenden:

  # Instanziiert eine Presentation-Klasse, die eine PPTX-Datei darstellt.
  $pres = new Presentation();
  try {
    $sld = $pres->getSlides()->get_Item(0);
    # Erstellt den PathFootball-Effekt für die vorhandene Form von Grund auf.
    $ashp = $sld->getShapes()->addAutoShape(ShapeType::Rectangle, 150, 150, 250, 25);
    $ashp->addTextFrame("Animated TextBox");
    # Fügt den PathFootball-Animationseffekt hinzu
    $pres->getSlides()->get_Item(0)->getTimeline()->getMainSequence()->addEffect($ashp, EffectType::PathFootball, EffectSubType::None, EffectTriggerType::AfterPrevious);
    # Erstellt eine Art "Button".
    $shapeTrigger = $pres->getSlides()->get_Item(0)->getShapes()->addAutoShape(ShapeType::Bevel, 10, 10, 20, 20);
    # Erstellt eine Sequenz von Effekten für diesen Button.
    $seqInter = $pres->getSlides()->get_Item(0)->getTimeline()->getInteractiveSequences()->add($shapeTrigger);
    # Erstellt einen benutzerdefinierten Pfad. Unser Objekt wird erst bewegt, nachdem der Button geklickt wurde.
    $fxUserPath = $seqInter->addEffect($ashp, EffectType::PathUser, EffectSubType::None, EffectTriggerType::OnClick);
    # Fügt Befehle zum Bewegen hinzu, da der erstellte Pfad leer ist.
    $motionBhv = $fxUserPath->getBehaviors()->get_Item(0);
    $pts = new Point2DFloat[1];
    $pts[0] = new Point2DFloat(0.076, 0.59);
    $motionBhv->getPath()->add(MotionCommandPathType::LineTo, $pts, MotionPathPointsType::Auto, true);
    $pts[0] = new Point2DFloat(-0.076, -0.59);
    $motionBhv->getPath()->add(MotionCommandPathType::LineTo, $pts, MotionPathPointsType::Auto, false);
    $motionBhv->getPath()->add(MotionCommandPathType::End, null, MotionPathPointsType::Auto, false);
    # Schreibt die PPTX-Datei auf die Festplatte
    $pres->save("AnimExample_out.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Die auf eine Form angewendeten Animationseffekte abrufen

Die folgenden Beispiele zeigen, wie Sie die Methode getEffectsByShape der Sequence-Klasse verwenden, um alle auf eine Form angewendeten Animationseffekte zu erhalten.

Beispiel 1: Animationseffekte einer Form auf einer normalen Folie abrufen

Zuvor haben Sie gelernt, wie Sie Animationseffekte zu Formen in PowerPoint‑Präsentationen hinzufügen. Der folgende Beispielcode zeigt, wie Sie die Effekte der ersten Form auf der ersten normalen Folie in der Präsentation AnimExample_out.pptx abrufen.

  $Array = new java_class("java.lang.reflect.Array");
  $presentation = new Presentation("AnimExample_out.pptx");

  try {
    $firstSlide = $presentation->getSlides()->get_Item(0);

    # Ermittelt die Hauptanimationssequenz der Folie.
    $sequence = $firstSlide->getTimeline()->getMainSequence();

    # Ermittelt die erste Form auf der ersten Folie.
    $shape = $firstSlide->getShapes()->get_Item(0);

    # Ermittelt die auf die Form angewendeten Animationseffekte.
    $shapeEffects = $sequence->getEffectsByShape($shape);

    if (java_values($Array->getLength($shapeEffects)) > 0) {
      echo("The shape " . $shape->getName() . " has " . $Array->getLength($shapeEffects) . " animation effects.");
    }
  } finally {
    if (!java_is_null($presentation)) {
      $presentation->dispose();
    }
  }

Beispiel 2: Alle Animationseffekte, einschließlich der von Platzhaltern geerbten, abrufen

Hat eine Form auf einer normalen Folie Platzhalter, die sich auf der Layout‑ oder Master‑Folie befinden, und wurden diesen Platzhaltern Animationseffekte zugewiesen, dann werden beim Vorführen alle Effekte der Form abgespielt, einschließlich der von den Platzhaltern geerbten.

Angenommen, wir haben eine PowerPoint‑Datei sample.pptx mit einer Folie, die nur eine Fußzeilen‑Form mit dem Text „Made with Aspose.Slides“ enthält, und der Random Bars‑Effekt ist auf die Form angewendet.

Folienform‑Animationseffekt

Angenommen, auf dem Layout‑Folie ist der Split‑Effekt auf den Fußzeilen‑Platzhalter angewendet.

Layout‑Form‑Animationseffekt

Und schließlich ist auf der Master‑Folie der Fly In‑Effekt auf den Fußzeilen‑Platzhalter angewendet.

Master‑Form‑Animationseffekt

Der folgende Beispielcode zeigt, wie Sie die Methode getBasePlaceholder der Shape-Klasse verwenden, um die Platzhalter der Form zu erreichen und die darauf angewendeten Animationseffekte, einschließlich der von Layout‑ und Master‑Platzhaltern geerbten, abzurufen.

$presentation = new Presentation("sample.pptx");

$slide = $presentation->getSlides()->get_Item(0);

// Ermittelt die Animationseffekte der Form auf der normalen Folie.
$shape = $slide->getShapes()->get_Item(0);
$shapeEffects = $slide->getTimeline()->getMainSequence()->getEffectsByShape($shape);

// Ermittelt die Animationseffekte des Platzhalters auf der Layout‑Folie.
$layoutShape = $shape->getBasePlaceholder();
$layoutShapeEffects = $slide->getLayoutSlide()->getTimeline()->getMainSequence()->getEffectsByShape($layoutShape);

// Ermittelt die Animationseffekte des Platzhalters auf der Master‑Folie.
$masterShape = $layoutShape->getBasePlaceholder();
$masterShapeEffects = $slide->getLayoutSlide()->getMasterSlide()->getTimeline()->getMainSequence()->getEffectsByShape($masterShape);

echo "Main sequence of shape effects:" . PHP_EOL;
printEffects($masterShapeEffects);
printEffects($layoutShapeEffects);
printEffects($shapeEffects);

$presentation->dispose();

function printEffects($effects) {
    foreach ($effects as $effect) {
        echo "Type: " . $effect->getType() . ", subtype: " . $effect->getSubtype() . PHP_EOL;
    }
}

Ausgabe:

Main sequence of shape effects:
Type: 47, subtype: 2              // Flug, unten
Type: 134, subtype: 45            // Aufteilen, vertikalEingang
Type: 126, subtype: 22            // Zufällige Balken, horizontal

Timing‑Eigenschaften eines Animationseffekts ändern

Aspose.Slides for PHP via Java ermöglicht es Ihnen, die Timing‑Eigenschaften eines Animationseffekts zu ändern.

Dies ist das Fenster Animation Timing in Microsoft PowerPoint:

example1_image

Die Entsprechungen zwischen PowerPoint‑Timing und den Eigenschaften von Effect.Timing sind:

Die Dropdown‑Liste Start im PowerPoint‑Timing entspricht der Eigenschaft Effect.Timing.TriggerType.
Duration entspricht der Eigenschaft Effect.Timing.Duration. Die Dauer einer Animation (in Sekunden) ist die Gesamtzeit, die die Animation für einen Zyklus benötigt.
Delay entspricht der Eigenschaft Effect.Timing.TriggerDelayTime.

So ändern Sie die Timing‑Eigenschaften des Effekts:

Anwenden oder erhalten Sie den Animationseffekt.
Setzen Sie neue Werte für die benötigten Effect.Timing‑Eigenschaften.
Speichern Sie die geänderte PPTX‑Datei.

Dieser PHP‑Code demonstriert den Vorgang:

  # Instanziert eine Präsentationsklasse, die eine Präsentationsdatei darstellt.
  $pres = new Presentation("AnimExample_out.pptx");
  try {
    # Ermittelt die Hauptsequenz der Folie.
    $sequence = $pres->getSlides()->get_Item(0)->getTimeline()->getMainSequence();
    # Ermittelt den ersten Effekt der Hauptsequenz.
    $effect = $sequence->get_Item(0);
    # Ändert den TriggerType des Effekts, sodass er bei Klick startet
    $effect->getTiming()->setTriggerType(EffectTriggerType::OnClick);
    # Ändert die Dauer des Effekts
    $effect->getTiming()->setDuration(3.0);
    # Ändert die TriggerDelayTime des Effekts
    $effect->getTiming()->setTriggerDelayTime(0.5);
    # Speichert die PPTX-Datei auf dem Datenträger
    $pres->save("AnimExample_changed.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Animationseffekt‑Ton

Aspose.Slides stellt diese Eigenschaften bereit, um mit Tönen in Animationseffekten zu arbeiten:

Einen Animationseffekt‑Ton hinzufügen

Dieser PHP‑Code zeigt, wie Sie einem Animationseffekt einen Ton hinzufügen und diesen stoppen, wenn der nächste Effekt beginnt:

  $pres = new Presentation("AnimExample_out.pptx");
  try {
    # Fügt Audio zur Audiosammlung der Präsentation hinzu
$Array = new JavaClass("java.lang.reflect.Array");
$Byte = (new JavaClass("java.lang.Byte"))->TYPE;
try {
    $dis = new Java("java.io.DataInputStream", new Java("java.io.FileInputStream", "sampleaudio.wav"));
    $bytes = $Array->newInstance($Byte, $dis->available());
    $dis->readFully($bytes);
} finally {
    if (!java_is_null($dis)) $dis->close();
}
    $effectSound = $pres->getAudios()->addAudio($bytes);

    $firstSlide = $pres->getSlides()->get_Item(0);
    # Ermittelt die Hauptsequenz der Folie.
    $sequence = $firstSlide->getTimeline()->getMainSequence();
    # Ermittelt den ersten Effekt der Hauptsequenz
    $firstEffect = $sequence->get_Item(0);
    # Prüft den Effekt auf "No Sound"
    if (java_is_null(!$firstEffect->getStopPreviousSound() && $firstEffect->getSound())) {
      # Fügt dem ersten Effekt einen Ton hinzu
      $firstEffect->setSound($effectSound);
    }
    # Ermittelt die erste interaktive Sequenz der Folie.
    $interactiveSequence = $firstSlide->getTimeline()->getInteractiveSequences()->get_Item(0);
    # Setzt das Flag "Stop previous sound" für den Effekt
    $interactiveSequence->get_Item(0)->setStopPreviousSound(true);
    # Schreibt die PPTX-Datei auf die Festplatte
    $pres->save("AnimExample_Sound_out.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Einen Animationseffekt‑Ton extrahieren

Erstellen Sie eine Instanz der Presentation-Klasse.
Holen Sie sich eine Folienreferenz über deren Index.
Erhalten Sie die Hauptsequenz der Effekte.
Extrahieren Sie den in jedem Animationseffekt eingebetteten setSound(IAudio value)‑Ton.

Dieser PHP‑Code zeigt, wie Sie den in einem Animationseffekt eingebetteten Ton extrahieren:

  # Instanziert eine Präsentationsklasse, die eine Präsentationsdatei darstellt.
  $presentation = new Presentation("EffectSound.pptx");
  try {
    $slide = $presentation->getSlides()->get_Item(0);
    # Ermittelt die Hauptsequenz der Folie.
    $sequence = $slide->getTimeline()->getMainSequence();
    foreach($sequence as $effect) {
      if (java_is_null($effect->getSound())) {
        continue;
      }
      # Extrahiert den Effektton in ein Byte-Array
      $audio = $effect->getSound()->getBinaryData();
    }
  } finally {
    if (!java_is_null($presentation)) {
      $presentation->dispose();
    }
  }

Nach der Animation

Aspose.Slides for PHP via Java ermöglicht es Ihnen, die After animation‑Eigenschaft eines Animationseffekts zu ändern.

Dies ist das Fenster Animation Effect und das erweiterte Menü in Microsoft PowerPoint:

example1_image

Die Dropdown‑Liste After animation in PowerPoint entspricht folgenden Eigenschaften:

Eigenschaft setAfterAnimationType(int value), die den Typ der Nach‑Animation beschreibt:
- More Colors entspricht dem Typ AfterAnimationType::Color;
- Don’t Dim entspricht dem Typ AfterAnimationType::DoNotDim (Standard‑Nach‑Animationstyp);
- Hide After Animation entspricht dem Typ AfterAnimationType::HideAfterAnimation;
- Hide on Next Mouse Click entspricht dem Typ AfterAnimationType::HideOnNextMouseClick;
Eigenschaft setAfterAnimationColor(IColorFormat value), die ein Nach‑Animations‑Farbformat definiert. Diese Eigenschaft wirkt zusammen mit dem Typ AfterAnimationType::Color. Ändern Sie den Typ, wird die Nach‑Animations‑Farbe gelöscht.

Dieser PHP‑Code zeigt, wie Sie einen Nach‑Animation‑Effekt ändern:

  # Instanziert eine Präsentationsklasse, die eine Präsentationsdatei darstellt
  $pres = new Presentation("AnimImage_out.pptx");
  try {
    $firstSlide = $pres->getSlides()->get_Item(0);
    # Ermittelt den ersten Effekt der Hauptsequenz
    $firstEffect = $firstSlide->getTimeline()->getMainSequence()->get_Item(0);
    # Ändert den After‑Animation‑Typ zu Color
    $firstEffect->setAfterAnimationType(AfterAnimationType::Color);
    # Setzt die After‑Animation‑Farbe
    $firstEffect->getAfterAnimationColor()->setColor(java("java.awt.Color")->BLUE);
    # Schreibt die PPTX-Datei auf die Festplatte
    $pres->save("AnimImage_AfterAnimation.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Text animieren

Aspose.Slides stellt diese Eigenschaften bereit, um mit dem Animate text‑Block eines Animationseffekts zu arbeiten:

setAnimateTextType(int value), die den Animations‑Text‑Typ des Effekts beschreibt. Der Form‑Text kann animiert werden:
- Alles auf einmal (AnimateTextType::AllAtOnce)
- Wortweise (AnimateTextType::ByWord)
- Buchstabenweise (AnimateTextType::ByLetter)
setDelayBetweenTextParts(float value) legt eine Verzögerung zwischen den animierten Textteilen (Wörtern oder Buchstaben) fest. Ein positiver Wert gibt den Prozentsatz der Effektdauer an. Ein negativer Wert gibt die Verzögerung in Sekunden an.

So ändern Sie die Eigenschaften Effect Animate text:

Anwenden oder erhalten Sie den Animationseffekt.
Setzen Sie die Eigenschaft setBuildType(int value) auf den Wert BuildType::AsOneObject, um den Animationsmodus By Paragraphs zu deaktivieren.
Setzen Sie neue Werte für die Eigenschaften setAnimateTextType(int value) und setDelayBetweenTextParts(float value).
Speichern Sie die geänderte PPTX‑Datei.

Dieser PHP‑Code demonstriert den Vorgang:

  # Instanziert eine Präsentationsklasse, die eine Präsentationsdatei darstellt.
  $pres = new Presentation("AnimTextBox_out.pptx");
  try {
    $firstSlide = $pres->getSlides()->get_Item(0);
    # Ermittelt den ersten Effekt der Hauptsequenz
    $firstEffect = $firstSlide->getTimeline()->getMainSequence()->get_Item(0);
    # Ändert den Textanimations-Typ des Effekts zu "As One Object"
    $firstEffect->getTextAnimation()->setBuildType(BuildType::AsOneObject);
    # Ändert den Animieren-Text-Typ des Effekts zu "By word"
    $firstEffect->setAnimateTextType(AnimateTextType::ByWord);
    # Setzt die Verzögerung zwischen den Wörtern auf 20% der Effektdauer
    $firstEffect->setDelayBetweenTextParts(20.0);
    # Schreibt die PPTX-Datei auf die Festplatte
    $pres->save("AnimTextBox_AnimateText.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

FAQ

Wie kann ich sicherstellen, dass Animationen beim Veröffentlichen der Präsentation im Web erhalten bleiben?

Export to HTML5 und aktivieren Sie die Optionen für shape‑ und transition‑Animationen. Reines HTML spielt Folienanimationen nicht ab, HTML5 jedoch schon.

Wie wirkt sich das Ändern der Z‑Reihenfolge (Layer‑Reihenfolge) von Formen auf Animationen aus?

Animations‑ und Zeichenreihenfolge sind unabhängig: Ein Effekt steuert das Timing und den Typ des Erscheinens/Verschwindens, während die z-order bestimmt, was was überdeckt. Das sichtbare Ergebnis ergibt sich aus ihrer Kombination. (Dies ist das allgemeine Verhalten von PowerPoint; das Aspose.Slides‑Modell für Effekte und Formen folgt derselben Logik.)

Gibt es Einschränkungen beim Konvertieren von Animationen in Video für bestimmte Effekte?

Im Allgemeinen werden Animationen unterstützt, aber seltene Fälle oder spezielle Effekte können anders gerendert werden. Es wird empfohlen, die von Ihnen genutzten Effekte und die Bibliotheksversion zu testen.

Ermitteln von effektiven Formeigenschaften aus Präsentationen in PHP Erstellen von Miniaturbildern von Präsentationsformen in PHP