Appliquer des animations de forme dans les présentations avec Java

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

Pourquoi utiliser des animations dans les présentations ?

En utilisant des 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 public
rendre le contenu plus facile à lire, assimiler ou traiter
attirer l’attention de vos lecteurs ou spectateurs sur les 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 dans l’espace de noms Aspose.Slides.Animation,
Aspose.Slides propose plus de 150 effets d’animation dans 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 pour Java vous permet d’appliquer une animation au texte d’une forme.

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

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

// Instancie une classe de présentation qui représente un fichier de présentation.
Presentation pres = new Presentation();
try {
    ISlide sld = pres.getSlides().get_Item(0);

    // Ajoute une nouvelle AutoShape avec du texte
    IAutoShape autoShape = sld.getShapes().addAutoShape(ShapeType.Rectangle, 20, 20, 150, 100);

    ITextFrame textFrame = autoShape.getTextFrame();
    textFrame.setText("First paragraph \nSecond paragraph \n Third paragraph");

    // Obtient la séquence principale de la diapositive.
    ISequence sequence = sld.getTimeline().getMainSequence();

    // Ajoute l'effet d'animation Fade à la forme
    IEffect effect = sequence.addEffect(autoShape, EffectType.Fade, EffectSubtype.None, EffectTriggerType.OnClick);

    // Anime le texte de la forme par paragraphes de premier niveau
    effect.getTextAnimation().setBuildType(BuildType.ByLevelParagraphs1);

    // Enregistre le fichier PPTX sur le disque
    pres.save(path + "AnimText_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

En plus d’appliquer des animations au texte, vous pouvez également appliquer des animations à un seul Paragraph. Voir Animated Text.

Appliquer une animation à un PictureFrame

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

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

// Instancie une classe de présentation qui représente un fichier de présentation.
Presentation pres = new Presentation();
try {
    // Charge l'image à ajouter dans la collection d'images de la présentation
    IPPImage picture;
    IImage image = Images.fromFile("aspose-logo.jpg");
    try {
        picture = pres.getImages().addImage(image);
    } finally {
        if (image != null) image.dispose();
    }

    // Ajoute une trame d'image à la diapositive
    IPictureFrame picFrame = pres.getSlides().get_Item(0).getShapes().addPictureFrame(ShapeType.Rectangle, 50, 50, 100, 100, picture);

    // Récupère la séquence principale de la diapositive.
    ISequence sequence = pres.getSlides().get_Item(0).getTimeline().getMainSequence();

    // Ajoute l'effet d'animation Fly depuis la gauche à la trame d'image
    IEffect 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(IOException e) {
} finally {
    if (pres != null) pres.dispose();
}

Appliquer une animation à une forme

Créez une instance de la classe Presentation.
Obtenez la référence d’une diapositive via son index.
Ajoutez un rectangle IAutoShape.
Ajoutez un Bevel IAutoShape (lorsque cet objet est cliqué, l’animation se déclenche).
Créez une séquence d’effets sur la forme en biseau.
Créez un UserPath personnalisé.
Ajoutez des commandes de déplacement vers le UserPath.
Enregistrez la présentation sur le disque au format PPTX.

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

// Instancie une classe Presentation qui représente un fichier PPTX.
Presentation pres = new Presentation();
try {
    ISlide sld = pres.getSlides().get_Item(0);

    // Crée l'effet PathFootball pour une forme existante à partir de zéro.
    IAutoShape 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".
    IShape shapeTrigger = pres.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Bevel, 10, 10, 20, 20);

    // Crée une séquence d'effets pour ce bouton.
    ISequence 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.
    IEffect fxUserPath = seqInter.addEffect(ashp, EffectType.PathUser, EffectSubtype.None, EffectTriggerType.OnClick);

     // Ajoute des commandes de déplacement puisque le chemin créé est vide.
    IMotionEffect motionBhv = ((IMotionEffect)fxUserPath.getBehaviors().get_Item(0));

    Point2D.Float[] pts = new Point2D.Float[1];
    pts[0] = new Point2D.Float(0.076f, 0.59f);
    motionBhv.getPath().add(MotionCommandPathType.LineTo, pts, MotionPathPointsType.Auto, true);
    pts[0] = new Point2D.Float(-0.076f, -0.59f);
    motionBhv.getPath().add(MotionCommandPathType.LineTo, pts, MotionPathPointsType.Auto, false);
    motionBhv.getPath().add(MotionCommandPathType.End, null, MotionPathPointsType.Auto, false);

     // Enregistre le fichier PPTX sur le disque
    pres.save("AnimExample_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

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

Les exemples suivants montrent comment utiliser la méthode getEffectsByShape de l’interface ISequence pour obtenir 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 montre comment obtenir les effets appliqués à la première forme de la première diapositive normale de la présentation AnimExample_out.pptx.

Presentation presentation = new Presentation("AnimExample_out.pptx");
try {
    ISlide firstSlide = presentation.getSlides().get_Item(0);

    // Récupère la séquence d'animation principale de la diapositive.
    ISequence sequence = firstSlide.getTimeline().getMainSequence();

    // Récupère la première forme de la première diapositive.
    IShape shape = firstSlide.getShapes().get_Item(0);

    // Récupère les effets d'animation appliqués à la forme.
    IEffect[] shapeEffects = sequence.getEffectsByShape(shape);

    if (shapeEffects.length > 0)
        System.out.println("The shape " + shape.getName() + " has " + shapeEffects.length + " animation effects.");
} finally {
    if (presentation != null) presentation.dispose();
}

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

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

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

Slide shape animation effect

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

Layout shape animation effect

Enfin, l’effet Fly In est appliqué à l’espace réservé du pied de page sur la diapositive master.

Master shape animation effect

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

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

ISlide slide = presentation.getSlides().get_Item(0);

// Get animation effects of the shape on the normal slide.
IShape shape = slide.getShapes().get_Item(0);
IEffect[] shapeEffects = slide.getTimeline().getMainSequence().getEffectsByShape(shape);

// Get animation effects of the placeholder on the layout slide.
IShape layoutShape = shape.getBasePlaceholder();
IEffect[] layoutShapeEffects = slide.getLayoutSlide().getTimeline().getMainSequence().getEffectsByShape(layoutShape);

// Get animation effects of the placeholder on the master slide.
IShape masterShape = layoutShape.getBasePlaceholder();
IEffect[] masterShapeEffects = slide.getLayoutSlide().getMasterSlide().getTimeline().getMainSequence().getEffectsByShape(masterShape);

System.out.println("Main sequence of shape effects:");
printEffects(masterShapeEffects);
printEffects(layoutShapeEffects);
printEffects(shapeEffects);

presentation.dispose();

static void printEffects(IEffect[] effects)
{
    for (IEffect effect : effects)
    {
        String typeName = EffectType.getName(EffectType.class, effect.getType());
        String subtypeName = EffectSubtype.getName(EffectSubtype.class, effect.getSubtype());

        System.out.println(typeName + " " + subtypeName);
    }
}

Output:

Main sequence of shape effects:
Fly Bottom
Split VerticalIn
RandomBars Horizontal

Modifier les propriétés de synchronisation des effets d’animation

Aspose.Slides pour Java vous permet de modifier les propriétés de synchronisation d’un effet d’animation.

Voici le volet Synchronisation des animations dans Microsoft PowerPoint :

example1_image

Correspondances entre la synchronisation PowerPoint et les propriétés Effect.Timing :

La liste déroulante Start du synchronisation PowerPoint correspond à la propriété Effect.Timing.TriggerType .
La Duration du synchronisation PowerPoint correspond à la propriété Effect.Timing.Duration . La durée d’une animation (en secondes) est le temps total nécessaire pour qu’elle complète un cycle.
Le Delay du synchronisation PowerPoint correspond à la propriété Effect.Timing.TriggerDelayTime .

Voici comment modifier les propriétés de synchronisation de l’effet :

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

// Instancie une classe de présentation qui représente un fichier de présentation.
Presentation pres = new Presentation("AnimExample_out.pptx");
try {
    // Récupère la séquence principale de la diapositive.
    ISequence sequence = pres.getSlides().get_Item(0).getTimeline().getMainSequence();

    // Récupère le premier effet de la séquence principale.
    IEffect effect = sequence.get_Item(0);

    // Modifie le type de déclenchement de l'effet pour démarrer au clic
    effect.getTiming().setTriggerType(EffectTriggerType.OnClick);

    // Modifie la durée de l'effet
    effect.getTiming().setDuration(3f);

    // Modifie le délai de déclenchement de l'effet
    effect.getTiming().setTriggerDelayTime(0.5f);

    // Enregistre le fichier PPTX sur le disque
    pres.save("AnimExample_changed.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Son d’effet d’animation

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

Ajouter un son à un effet d’animation

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

Presentation pres = new Presentation("AnimExample_out.pptx");
try {
    // Ajoute un audio à la collection audio de la présentation
    IAudio effectSound = pres.getAudios().addAudio(Files.readAllBytes(Paths.get("sampleaudio.wav")));

    ISlide firstSlide = pres.getSlides().get_Item(0);

    // Récupère la séquence principale de la diapositive.
    ISequence sequence = firstSlide.getTimeline().getMainSequence();

    // Récupère le premier effet de la séquence principale
    IEffect firstEffect = sequence.get_Item(0);

    // Vérifie l'effet pour "Pas de son"
    if (!firstEffect.getStopPreviousSound() && firstEffect.getSound() == null)
    {
        // Ajoute le son au premier effet
        firstEffect.setSound(effectSound);
    }

    // Récupère la première séquence interactive de la diapositive.
    ISequence 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 (pres != null) pres.dispose();
}

Extraire le son d’un effet d’animation

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

Ce code Java montre comment extraire le son intégré dans un effet d’animation :

// Instancie une classe de présentation qui représente un fichier de présentation.
Presentation presentation = new Presentation("EffectSound.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    // Récupère la séquence principale de la diapositive.
    ISequence sequence = slide.getTimeline().getMainSequence();

    for (IEffect effect : sequence)
    {
        if (effect.getSound() == null)
            continue;

        // Extrait le son de l'effet sous forme de tableau d'octets
        byte[] audio = effect.getSound().getBinaryData();
    }
} finally {
    if (presentation != null) presentation.dispose();
}

Après l’animation

Aspose.Slides pour Java vous permet de changer la propriété Après l’animation d’un effet d’animation.

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

example1_image

La liste déroulante PowerPoint After animation correspond à ces propriétés :

La propriété setAfterAnimationType(int value) qui décrit le type d’après animation :
- PowerPoint More Colors correspond au type AfterAnimationType.Color ;
- PowerPoint Don’t Dim correspond au type AfterAnimationType.DoNotDim (type d’après animation par défaut) ;
- PowerPoint Hide After Animation correspond au type AfterAnimationType.HideAfterAnimation ;
- PowerPoint Hide on Next Mouse Click correspond au type AfterAnimationType.HideOnNextMouseClick ;
La propriété setAfterAnimationColor(IColorFormat value) qui définit un format de couleur après l’animation. Cette propriété fonctionne avec le type AfterAnimationType.Color. Si vous changez le type, la couleur après l’animation sera effacée.

Ce code Java montre comment changer un effet après l’animation :

// Instancie une classe de présentation qui représente un fichier de présentation
Presentation pres = new Presentation("AnimImage_out.pptx");
try {
    ISlide firstSlide = pres.getSlides().get_Item(0);

    // Récupère le premier effet de la séquence principale
    IEffect 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'atténuation après l'animation
    firstEffect.getAfterAnimationColor().setColor(Color.BLUE);

    // Enregistre le fichier PPTX sur le disque
    pres.save("AnimImage_AfterAnimation.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Animer le texte

Aspose.Slides fournit ces propriétés pour vous permettre de 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 animées du texte (mots ou lettres). Une valeur positive spécifie le pourcentage de la durée de l’effet. Une valeur négative spécifie le délai en secondes.

Voici comment vous pouvez modifier les propriétés d’animation du texte :

Appliquer ou récupérer l’effet d’animation.
Définissez la propriété setBuildType(int value) sur la valeur BuildType.AsOneObject pour désactiver le mode d’animation Par paragraphes.
Définissez de nouvelles valeurs pour les propriétés setAnimateTextType(int value) et setDelayBetweenTextParts(float value).
Enregistrez le fichier PPTX modifié.

// Instancie une classe de présentation qui représente un fichier de présentation.
Presentation pres = new Presentation("AnimTextBox_out.pptx");
try {
    ISlide firstSlide = pres.getSlides().get_Item(0);

    // Récupère le premier effet de la séquence principale
    IEffect 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(20f);

    // Enregistre le fichier PPTX sur le disque
    pres.save("AnimTextBox_AnimateText.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) 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 de l’ordre Z (ordre des calques) des formes affecte-t-il l’animation ?

L’ordre Z 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 est défini par leur combinaison. (Ceci est le comportement général de PowerPoint ; le modèle d’effets‑et‑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 supportées, 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.

Obtenir les propriétés effectives des formes à partir des présentations en Java Créer des miniatures de formes de présentation en Java