Appliquer des animations de formes aux présentations avec PHP

Les animations sont des effets visuels qui peuvent être appliqués aux textes, aux images, aux formes ou aux graphiques. Elles donnent vie aux présentations ou à leurs constituants.

Pourquoi utiliser les animations dans les présentations ?

En utilisant les animations, vous pouvez

• contrôler le flux d’informations
• mettre en évidence les points importants
• augmenter l’intérêt ou la participation de votre audience
• rendre le contenu plus facile à lire, assimiler ou traiter
• attirer l’attention de vos lecteurs ou spectateurs sur des parties importantes d’une présentation

PowerPoint offre de nombreuses options et outils pour les animations et les effets d’animation dans les catégories entrée, sortie, mise en évidence et chemins de mouvement.

Animations dans Aspose.Slides

• Aspose.Slides fournit les classes et types dont vous avez besoin pour travailler avec les animations sous l’espace de noms Aspose.Slides.Animation,
• Aspose.Slides propose plus de 150 effets d’animation sous l’énumération EffectType. Ces effets sont essentiellement les mêmes (ou équivalents) que ceux utilisés dans PowerPoint.

Appliquer une animation à une zone de texte

Aspose.Slides for PHP via Java vous permet d’appliquer une animation au texte d’une forme.

1. Créez une instance de la classe Presentation.
2. Obtenez une référence à une diapositive via son index.
3. Ajoutez un rectangle IAutoShape.
4. Ajoutez du texte à IAutoShape.TextFrame.
5. Récupérez la séquence principale d’effets.
6. Ajoutez un effet d’animation à IAutoShape.
7. Définissez la propriété TextAnimation.BuildType sur la valeur de l’énumération BuildType.
8. Enregistrez la présentation sur le disque au format PPTX.

Ce code PHP vous montre comment appliquer l’effet Fade à une AutoShape et définir l’animation du texte sur la valeur Par paragraphes de niveau 1 :

  # Instancie une classe de présentation représentant un fichier de présentation.
  $pres = new Presentation();
  try {
    $sld = $pres->getSlides()->get_Item(0);
    # Ajoute une nouvelle AutoShape avec du texte
    $autoShape = $sld->getShapes()->addAutoShape(ShapeType::Rectangle, 20, 20, 150, 100);
    $textFrame = $autoShape->getTextFrame();
    $textFrame->setText("First paragraph \nSecond paragraph \n Third paragraph");
    # Obtient la séquence principale de la diapositive.
    $sequence = $sld->getTimeline()->getMainSequence();
    # Ajoute l'effet d'animation Fade à la forme
    $effect = $sequence->addEffect($autoShape, EffectType::Fade, EffectSubType::None, EffectTriggerType::OnClick);
    # Anime le texte de la forme par paragraphes de niveau 1
    $effect->getTextAnimation()->setBuildType(BuildType::ByLevelParagraphs1);
    # Enregistre le fichier PPTX sur le disque
    $pres->save($path . "AnimText_out.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

En plus d’appliquer des animations au texte, vous pouvez également appliquer des animations à un seul Paragraph. Consultez Texte animé.

Appliquer une animation à un PictureFrame

1. Créez une instance de la classe Presentation.
2. Obtenez une référence à une diapositive via son index.
3. Ajoutez ou récupérez un PictureFrame sur la diapositive.
4. Récupérez la séquence principale d’effets.
5. Ajoutez un effet d’animation à PictureFrame.
6. Enregistrez la présentation sur le disque au format PPTX.

Ce code PHP vous montre comment appliquer l’effet Fly à un cadre d’image :

  # Instancie une classe de présentation représentant un fichier de présentation.
  $pres = new Presentation();
  try {
    # Charge l'image à ajouter dans la collection d'images de la présentation
    $picture;
    $image = Images->fromFile("aspose-logo.jpg");
    try {
      $picture = $pres->getImages()->addImage($image);
    } finally {
      if (!java_is_null($image)) {
        $image->dispose();
      }
    }
    # Ajoute un cadre d'image à la diapositive
    $picFrame = $pres->getSlides()->get_Item(0)->getShapes()->addPictureFrame(ShapeType::Rectangle, 50, 50, 100, 100, $picture);
    # Obtient la séquence principale de la diapositive.
    $sequence = $pres->getSlides()->get_Item(0)->getTimeline()->getMainSequence();
    # Ajoute l'effet d'animation Fly depuis la gauche au cadre d'image
    $effect = $sequence->addEffect($picFrame, EffectType::Fly, EffectSubType::Left, EffectTriggerType::OnClick);
    # Enregistre le fichier PPTX sur le disque
    $pres->save($path . "AnimImage_out.pptx", SaveFormat::Pptx);
  } catch (JavaException $e) {
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Appliquer une animation à une forme

1. Créez une instance de la classe Presentation.
2. Obtenez une référence à une diapositive via son index.
3. Ajoutez un rectangle IAutoShape.
4. Ajoutez un Bevel IAutoShape (lorsque cet objet est cliqué, l’animation se lance).
5. Créez une séquence d’effets sur la forme en chanfrein.
6. Créez un UserPath personnalisé.
7. Ajoutez des commandes pour se déplacer vers le UserPath.
8. Enregistrez la présentation sur le disque au format PPTX.

Ce code PHP vous montre comment appliquer l’effet PathFootball (chemin football) à une forme :

  # Instancie une classe Presentation qui représente un fichier PPTX.
  $pres = new Presentation();
  try {
    $sld = $pres->getSlides()->get_Item(0);
    # Crée l'effet PathFootball pour la forme existante à partir de zéro.
    $ashp = $sld->getShapes()->addAutoShape(ShapeType::Rectangle, 150, 150, 250, 25);
    $ashp->addTextFrame("Animated TextBox");
    # Ajoute l'effet d'animation PathFootBall
    $pres->getSlides()->get_Item(0)->getTimeline()->getMainSequence()->addEffect($ashp, EffectType::PathFootball, EffectSubType::None, EffectTriggerType::AfterPrevious);
    # Crée une sorte de "bouton".
    $shapeTrigger = $pres->getSlides()->get_Item(0)->getShapes()->addAutoShape(ShapeType::Bevel, 10, 10, 20, 20);
    # Crée une séquence d'effets pour ce bouton.
    $seqInter = $pres->getSlides()->get_Item(0)->getTimeline()->getInteractiveSequences()->add($shapeTrigger);
    # Crée un chemin utilisateur personnalisé. Notre objet ne sera déplacé qu'après le clic sur le bouton.
    $fxUserPath = $seqInter->addEffect($ashp, EffectType::PathUser, EffectSubType::None, EffectTriggerType::OnClick);
    # Ajoute des commandes de déplacement puisque le chemin créé est vide.
    $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);
    # Écrit le fichier PPTX sur le disque
    $pres->save("AnimExample_out.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Obtenir les effets d’animation appliqués à une forme

Les exemples suivants montrent comment utiliser la méthode getEffectsByShape de la classe Sequence pour récupérer tous les effets d’animation appliqués à une forme.

Exemple 1 : Obtenir les effets d’animation appliqués à une forme sur une diapositive normale

Auparavant, vous avez appris comment ajouter des effets d’animation aux formes dans les présentations PowerPoint. Le code d’exemple suivant vous montre comment récupérer les effets appliqués à la première forme de la première diapositive normale de la présentation AnimExample_out.pptx.

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

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

    # Obtient la séquence principale d'animation de la diapositive.
    $sequence = $firstSlide->getTimeline()->getMainSequence();

    # Obtient la première forme de la première diapositive.
    $shape = $firstSlide->getShapes()->get_Item(0);

    # Obtient les effets d'animation appliqués à la forme.
    $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();
    }
  }

Exemple 2 : Obtenir tous les effets d’animation, y compris ceux hérités des zones réservées

Si une forme sur une diapositive normale possède des zones réservées provenant de la diapositive modèle et/ou maître, et que des effets d’animation ont été ajoutés à ces zones réservées, alors tous les effets de la forme seront joués lors du diaporama, y compris ceux hérités des zones réservées.

Imaginons que nous ayons un fichier de présentation PowerPoint sample.pptx contenant une seule diapositive avec uniquement une forme de pied de page affichant le texte « Made with Aspose.Slides » et que l’effet Random Bars soit appliqué à la forme.

Supposons également que l’effet Split soit appliqué à la zone réservée du pied de page sur la diapositive layout.

Enfin, que l’effet Fly In soit appliqué à la zone réservée du pied de page sur la diapositive master.

Le code d’exemple suivant montre comment utiliser la méthode getBasePlaceholder de la classe Shape pour accéder aux zones réservées de la forme et récupérer les effets d’animation appliqués à la forme de pied de page, y compris ceux hérités des zones réservées situées sur les diapositives de mise en page et maître.

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

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

// Obtenir les effets d'animation de la forme sur la diapositive normale.
$shape = $slide->getShapes()->get_Item(0);
$shapeEffects = $slide->getTimeline()->getMainSequence()->getEffectsByShape($shape);

// Obtenir les effets d'animation du placeholder sur la diapositive de mise en page.
$layoutShape = $shape->getBasePlaceholder();
$layoutShapeEffects = $slide->getLayoutSlide()->getTimeline()->getMainSequence()->getEffectsByShape($layoutShape);

// Obtenir les effets d'animation du placeholder sur la diapositive maîtresse.
$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;
    }
}

Sortie :

Main sequence of shape effects:
Type: 47, subtype: 2              // Fly, Bas
Type: 134, subtype: 45            // Diviser, VerticalIn
Type: 126, subtype: 22            // BarresAléatoires, Horizontal

Modifier les propriétés de timing d’un effet d’animation

Aspose.Slides for PHP via Java vous permet de modifier les propriétés de timing d’un effet d’animation.

Voici le volet Timing de l’animation dans Microsoft PowerPoint :

Correspondances entre le Timing de PowerPoint et les propriétés Effect.Timing :

• La liste déroulante Start du Timing de PowerPoint correspond à la propriété Effect.Timing.TriggerType.
• La valeur Duration du Timing de PowerPoint correspond à la propriété Effect.Timing.Duration. La durée d’une animation (en secondes) est le temps total nécessaire à l’animation pour compléter un cycle.
• La valeur Delay du Timing de PowerPoint correspond à la propriété Effect.Timing.TriggerDelayTime.

Voici comment modifier les propriétés de timing d’un effet :

1. Appliquer ou récupérer l’effet d’animation.
2. Définir de nouvelles valeurs pour les propriétés Effect.Timing dont vous avez besoin.
3. Enregistrer le fichier PPTX modifié.

Ce code PHP montre l’opération :

  # Instancie une classe de présentation qui représente un fichier de présentation.
  $pres = new Presentation("AnimExample_out.pptx");
  try {
    # Obtient la séquence principale de la diapositive.
    $sequence = $pres->getSlides()->get_Item(0)->getTimeline()->getMainSequence();
    # Obtient le premier effet de la séquence principale.
    $effect = $sequence->get_Item(0);
    # Modifie le TriggerType de l'effet pour démarrer au clic
    $effect->getTiming()->setTriggerType(EffectTriggerType::OnClick);
    # Modifie la durée de l'effet
    $effect->getTiming()->setDuration(3.0);
    # Modifie le temps de retard du déclencheur de l'effet
    $effect->getTiming()->setTriggerDelayTime(0.5);
    # Enregistre le fichier PPTX sur le disque
    $pres->save("AnimExample_changed.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Son d’un effet d’animation

Aspose.Slides fournit ces propriétés pour travailler avec les sons dans les effets d’animation :

• setSound(IAudio value)
• setStopPreviousSound(boolean value)

Ajouter un son à un effet d’animation

Ce code PHP montre comment ajouter un son à un effet d’animation et l’arrêter lorsque l’effet suivant démarre :

  $pres = new Presentation("AnimExample_out.pptx");
  try {
    # Ajoute un audio à la collection audio de la présentation
$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);
    # Récupère la séquence principale de la diapositive.
    $sequence = $firstSlide->getTimeline()->getMainSequence();
    # Récupère le premier effet de la séquence principale
    $firstEffect = $sequence->get_Item(0);
    # Vérifie que l'effet n'a pas de son
    if (java_is_null(!$firstEffect->getStopPreviousSound() && $firstEffect->getSound())) {
      # Ajoute le son au premier effet
      $firstEffect->setSound($effectSound);
    }
    # Récupère la première séquence interactive de la diapositive.
    $interactiveSequence = $firstSlide->getTimeline()->getInteractiveSequences()->get_Item(0);
    # Définit le drapeau "Stop previous sound" de l'effet
    $interactiveSequence->get_Item(0)->setStopPreviousSound(true);
    # Enregistre le fichier PPTX sur le disque
    $pres->save("AnimExample_Sound_out.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Extraire le son d’un effet d’animation

1. Créez une instance de la classe Presentation.
2. Obtenez une référence à une diapositive via son index.
3. Récupérez la séquence principale d’effets.
4. Extrayez le son intégré via la méthode setSound(IAudio value) de chaque effet d’animation.

Ce code PHP montre comment extraire le son incorporé dans un effet d’animation :

  # Instancie une classe de présentation qui représente un fichier de présentation.
  $presentation = new Presentation("EffectSound.pptx");
  try {
    $slide = $presentation->getSlides()->get_Item(0);
    # Obtient la séquence principale de la diapositive.
    $sequence = $slide->getTimeline()->getMainSequence();
    foreach($sequence as $effect) {
      if (java_is_null($effect->getSound())) {
        continue;
      }
      # Extrait le son de l'effet sous forme de tableau d'octets
      $audio = $effect->getSound()->getBinaryData();
    }
  } finally {
    if (!java_is_null($presentation)) {
      $presentation->dispose();
    }
  }

Après l’animation

Aspose.Slides for PHP via Java vous permet de modifier la propriété After animation d’un effet d’animation.

Voici le volet Effet d’animation et le menu étendu dans Microsoft PowerPoint :

La liste déroulante After animation de PowerPoint correspond aux propriétés suivantes :

• Propriété setAfterAnimationType(int value) qui décrit le type d’After animation :
  • More Colors correspond au type AfterAnimationType::Color;
  • Don’t Dim correspond au type AfterAnimationType::DoNotDim (type par défaut) ;
  • Hide After Animation correspond au type AfterAnimationType::HideAfterAnimation ;
  • Hide on Next Mouse Click correspond au type AfterAnimationType::HideOnNextMouseClick.
• Propriété setAfterAnimationColor(IColorFormat value) qui définit un format de couleur After animation. Cette propriété fonctionne en conjonction avec le type AfterAnimationType::Color. Si vous changez le type, la couleur After animation sera réinitialisée.

Ce code PHP montre comment modifier un effet After animation :

  # Instancie une classe de présentation qui représente un fichier de présentation
  $pres = new Presentation("AnimImage_out.pptx");
  try {
    $firstSlide = $pres->getSlides()->get_Item(0);
    # Obtient le premier effet de la séquence principale
    $firstEffect = $firstSlide->getTimeline()->getMainSequence()->get_Item(0);
    # Modifie le type d'animation après en Couleur
    $firstEffect->setAfterAnimationType(AfterAnimationType::Color);
    # Définit la couleur d'animation après
    $firstEffect->getAfterAnimationColor()->setColor(java("java.awt.Color")->BLUE);
    # Enregistre le fichier PPTX sur le disque
    $pres->save("AnimImage_AfterAnimation.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Animer le texte

Aspose.Slides fournit ces propriétés pour travailler avec le bloc Animate text d’un effet d’animation :

• setAnimateTextType(int value) qui décrit le type d’animation du texte de l’effet. Le texte de la forme peut être animé :
  • Tout d’un coup (AnimateTextType::AllAtOnce)
  • Par mot (AnimateTextType::ByWord)
  • Par lettre (AnimateTextType::ByLetter)
• setDelayBetweenTextParts(float value) définit un délai entre les parties de texte animées (mots ou lettres). Une valeur positive indique le pourcentage de la durée de l’effet. Une valeur négative indique le délai en secondes.

Voici comment modifier les propriétés Animate text d’un effet :

1. Appliquer ou récupérer l’effet d’animation.
2. Définir la propriété setBuildType(int value) sur la valeur BuildType::AsOneObject pour désactiver le mode By Paragraphs.
3. Définir de nouvelles valeurs pour les propriétés setAnimateTextType(int value) et setDelayBetweenTextParts(float value).
4. Enregistrer le fichier PPTX modifié.

Ce code PHP montre l’opération :

  # Instancie une classe de présentation qui représente un fichier de présentation.
  $pres = new Presentation("AnimTextBox_out.pptx");
  try {
    $firstSlide = $pres->getSlides()->get_Item(0);
    # Récupère le premier effet de la séquence principale
    $firstEffect = $firstSlide->getTimeline()->getMainSequence()->get_Item(0);
    # Modifie le type d'animation du texte de l'effet en "As One Object"
    $firstEffect->getTextAnimation()->setBuildType(BuildType::AsOneObject);
    # Modifie le type d'animation du texte de l'effet en "By word"
    $firstEffect->setAnimateTextType(AnimateTextType::ByWord);
    # Définit le délai entre les mots à 20 % de la durée de l'effet
    $firstEffect->setDelayBetweenTextParts(20.0);
    # Enregistre le fichier PPTX sur le disque
    $pres->save("AnimTextBox_AnimateText.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

FAQ

Comment garantir que les animations sont conservées lors de la publication de la présentation sur le Web ?

Export to HTML5 et activez les options responsables des animations de shape et de transition. Le HTML simple ne lit pas les animations de diapositive, alors que le HTML5 le fait.

Comment le changement d’ordre Z (ordre des calques) des formes affecte‑t‑il les animations ?

L’ordre d’animation et l’ordre de dessin sont indépendants : un effet contrôle le moment et le type d’apparition/disparition, tandis que l’z‑order détermine ce qui recouvre quoi. Le résultat visible résulte de leur combinaison. (C’est le comportement général de PowerPoint ; le modèle d’effets et de formes d’Aspose.Slides suit la même logique.)

Existe‑t‑il des limitations lors de la conversion des animations en vidéo pour certains effets ?

En général, les animations sont prises en charge, mais des cas rares ou des effets spécifiques peuvent être rendus différemment. Il est recommandé de tester avec les effets que vous utilisez et avec la version de la bibliothèque.