Applicare animazioni di forme nelle presentazioni con Python

Introduzione

Le animazioni sono effetti visivi che possono essere applicati a testi, immagini, forme o grafici. Danno vita alle presentazioni o ai loro componenti.

Perché usare le animazioni nelle presentazioni?

  • controllare il flusso di informazioni
  • sottolineare i punti importanti
  • aumentare l’interesse o la partecipazione del pubblico
  • rendere il contenuto più facile da leggere, assimilare o elaborare
  • catturare l’attenzione dei lettori o spettatori verso le parti importanti di una presentazione

PowerPoint offre molte opzioni e strumenti per le animazioni e gli effetti di animazione nelle categorie entrata, uscita, enfasi e percorsi di movimento.

Animazioni in Aspose.Slides

  • Aspose.Slides fornisce le classi e i tipi necessari per lavorare con le animazioni nel namespace Aspose.Slides.Animation,
  • Aspose.Slides fornisce più di 150 effetti di animazione nell’enumerazione EffectType. Questi effetti sono sostanzialmente gli stessi (o equivalenti) effetti usati in PowerPoint.

Applicare l’animazione a TextBox

Aspose.Slides per Python tramite .NET consente di applicare animazioni al testo in una forma.

  1. Crea un’istanza della classe Presentation.
  2. Ottieni un riferimento alla slide tramite il suo indice.
  3. Aggiungi un rectangle IAutoShape.
  4. Aggiungi testo a IAutoShape.TextFrame.
  5. Ottieni la sequenza principale di effetti.
  6. Aggiungi un effetto di animazione a IAutoShape.
  7. Imposta la proprietà TextAnimation.BuildType al valore dell’enumerazione BuildType.
  8. Scrivi la presentazione su disco come file PPTX.

Questo codice Python mostra come applicare l’effetto Fade a AutoShape e impostare l’animazione del testo sul valore By 1st Level Paragraphs:

import aspose.slides as slides

# Istanzia una classe di presentazione che rappresenta un file di presentazione.
with slides.Presentation() as pres:
    sld = pres.slides[0]
    
    # Aggiunge una nuova AutoShape con testo
    autoShape = sld.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 20, 20, 150, 100)

    textFrame = autoShape.text_frame
    textFrame.text = "First paragraph \nSecond paragraph \n Third paragraph"

    # Ottiene la sequenza principale della slide.
    sequence = sld.timeline.main_sequence

    # Aggiunge l'effetto di animazione Fade alla forma
    effect = sequence.add_effect(autoShape, slides.animation.EffectType.FADE, slides.animation.EffectSubtype.NONE, slides.animation.EffectTriggerType.ON_CLICK)

    # Anima il testo della forma per paragrafi di primo livello
    effect.text_animation.build_type = slides.animation.BuildType.BY_LEVEL_PARAGRAPHS1

    # Salva il file PPTX su disco
    pres.save("AnimText_out.pptx", slides.export.SaveFormat.PPTX)

Applicare l’animazione a PictureFrame

  1. Crea un’istanza della classe Presentation.
  2. Ottieni un riferimento alla slide tramite il suo indice.
  3. Aggiungi o ottieni un PictureFrame sulla slide.
  4. Ottieni la sequenza principale di effetti.
  5. Aggiungi un effetto di animazione a PictureFrame.
  6. Scrivi la presentazione su disco come file PPTX.

Questo codice Python mostra come applicare l’effetto Fly a un picture frame:

import aspose.slides as slides
import aspose.pydrawing as draw


# Istanzia una classe di presentazione che rappresenta un file di presentazione.
with slides.Presentation() as pres:
    # Carica l'immagine da aggiungere alla raccolta di immagini della presentazione
    img = draw.Bitmap("aspose-logo.jpg")
    image = pres.images.add_image(img)

    # Aggiunge un fotogramma immagine alla slide
    picFrame = pres.slides[0].shapes.add_picture_frame(slides.ShapeType.RECTANGLE, 50, 50, 100, 100, image)

    # Ottiene la sequenza principale della slide.
    sequence = pres.slides[0].timeline.main_sequence

    # Aggiunge l'effetto di animazione Fly da sinistra al fotogramma immagine
    effect = sequence.add_effect(picFrame, slides.animation.EffectType.FLY,  
        slides.animation.EffectSubtype.LEFT, 
        slides.animation.EffectTriggerType.ON_CLICK)

    # Salva il file PPTX su disco
    pres.save("AnimImage_out.pptx", slides.export.SaveFormat.PPTX)

Applicare l’animazione a Shape

  1. Crea un’istanza della classe Presentation.
  2. Ottieni un riferimento alla slide tramite il suo indice.
  3. Aggiungi un rectangle IAutoShape.
  4. Aggiungi un Bevel IAutoShape (quando questo oggetto viene cliccato, l’animazione viene riprodotta).
  5. Crea una sequenza di effetti sulla forma Bevel.
  6. Crea un UserPath personalizzato.
  7. Aggiungi comandi per spostarsi al UserPath.
  8. Scrivi la presentazione su disco come file PPTX.

Questo codice Python mostra come applicare l’effetto PathFootball (path football) a una forma:

import aspose.slides.animation as anim
import aspose.slides as slides
import aspose.pydrawing as draw

# Istanzia una classe Presentation che rappresenta un file PPTX
with slides.Presentation() as pres:
    sld = pres.slides[0]

    # Crea l'effetto PathFootball per la forma esistente da zero.
    ashp = sld.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 150, 150, 250, 25)

    ashp.add_text_frame("Animated TextBox")

    # Aggiunge l'effetto di animazione PathFootBall.
    pres.slides[0].timeline.main_sequence.add_effect(ashp, 
        anim.EffectType.PATH_FOOTBALL,
        anim.EffectSubtype.NONE, 
        anim.EffectTriggerType.AFTER_PREVIOUS)

    # Crea una sorta di "button".
    shapeTrigger = pres.slides[0].shapes.add_auto_shape(slides.ShapeType.BEVEL, 10, 10, 20, 20)

    # Crea una sequenza di effetti per il pulsante.
    seqInter = pres.slides[0].timeline.interactive_sequences.add(shapeTrigger)

    # Crea un percorso utente personalizzato. Il nostro oggetto verrà spostato solo dopo che il pulsante viene cliccato.
    fxUserPath = seqInter.add_effect(ashp, 
        anim.EffectType.PATH_USER, 
        anim.EffectSubtype.NONE, 
        anim.EffectTriggerType.ON_CLICK)

    # Aggiunge comandi per lo spostamento poiché il percorso creato è vuoto.
    motionBhv = fxUserPath.behaviors[0]

    pts = [draw.PointF(0.076, 0.59)]
    motionBhv.path.add(anim.MotionCommandPathType.LINE_TO, pts, anim.MotionPathPointsType.AUTO, True)
    pts = [draw.PointF(-0.076, -0.59)]
    motionBhv.path.add(anim.MotionCommandPathType.LINE_TO, pts, anim.MotionPathPointsType.AUTO, False)
    motionBhv.path.add(anim.MotionCommandPathType.END, None, anim.MotionPathPointsType.AUTO, False)

    # Scrive il file PPTX su disco
    pres.save("AnimExample_out.pptx", slides.export.SaveFormat.PPTX)

Ottenere gli effetti di animazione applicati a Shape

Gli esempi seguenti mostrano come utilizzare il metodo get_effects_by_shape della classe Sequence per ottenere tutti gli effetti di animazione applicati a una forma.

Esempio 1: Ottenere gli effetti di animazione applicati a una forma su una slide normale

In precedenza hai imparato come aggiungere effetti di animazione alle forme nelle presentazioni PowerPoint. Il codice di esempio seguente mostra come ottenere gli effetti applicati alla prima forma della prima slide normale nella presentazione AnimExample_out.pptx.

import aspose.slides as slides

with slides.Presentation("AnimExample_out.pptx") as presentation:
    first_slide = presentation.slides[0]

    # Ottiene la sequenza principale di animazione della slide.
    sequence = first_slide.timeline.main_sequence

    # Ottiene la prima forma sulla prima slide.
    shape = first_slide.shapes[0]

    # Ottiene gli effetti di animazione applicati alla forma.
    shape_effects = sequence.get_effects_by_shape(shape)

    if len(shape_effects) > 0:
        print("The shape", shape.name, "has", len(shape_effects), "animation effects.")

Esempio 2: Ottenere tutti gli effetti di animazione, inclusi quelli ereditati dai segnaposti

Se una forma su una slide normale ha segnaposti che si trovano sulla slide layout e/o master, e sono stati aggiunti effetti di animazione a questi segnaposti, allora tutti gli effetti della forma verranno riprodotti durante la presentazione, inclusi quelli ereditati dai segnaposti.

Supponiamo di avere un file di presentazione PowerPoint sample.pptx con una slide contenente solo una forma piè di pagina con il testo “Made with Aspose.Slides” e l’effetto Random Bars è applicato alla forma.

Effetto di animazione della forma nella slide

Supponiamo inoltre che l’effetto Split sia applicato al segnaposto piè di pagina nella slide layout.

Effetto di animazione della forma nella slide layout

Infine, l’effetto Fly In è applicato al segnaposto piè di pagina nella slide master.

Effetto di animazione della forma nella slide master

Il codice di esempio seguente mostra come utilizzare il metodo get_base_placeholder della classe Shape per accedere ai segnaposti delle forme e ottenere gli effetti di animazione applicati alla forma piè di pagina, inclusi quelli ereditati dai segnaposti situati sulle slide layout e master.

import aspose.slides as slides

def print_effects(effects):
    for effect in effects:
        print(effect.type.name, effect.subtype.name)

with slides.Presentation("sample.pptx") as presentation:
    slide = presentation.slides[0]

    # Ottieni gli effetti di animazione della forma sulla slide normale.
    shape = slide.shapes[0]
    shape_effects = slide.timeline.main_sequence.get_effects_by_shape(shape)

    # Ottieni gli effetti di animazione del segnaposto sulla slide di layout.
    layout_shape = shape.get_base_placeholder()
    layout_shape_effects = slide.layout_slide.timeline.main_sequence.get_effects_by_shape(layout_shape)

    # Ottieni gli effetti di animazione del segnaposto sulla slide master.
    master_shape = layout_shape.get_base_placeholder()
    master_shape_effects = slide.layout_slide.master_slide.timeline.main_sequence.get_effects_by_shape(master_shape)

    print("Main sequence of shape effects:")
    print_effects(master_shape_effects)
    print_effects(layout_shape_effects)
    print_effects(shape_effects)

Output:

Main sequence of shape effects:
FLY BOTTOM
SPLIT VERTICAL_IN
RANDOM_BARS HORIZONTAL

Modificare le proprietà di temporizzazione dell’effetto di animazione

Aspose.Slides per Python tramite .NET consente di modificare le proprietà di temporizzazione di un effetto di animazione.

Questo è il pannello di temporizzazione dell’animazione in Microsoft PowerPoint:

Pannello di temporizzazione dell’animazione

Queste sono le corrispondenze tra la temporizzazione di PowerPoint e le proprietà Effect.Timing:

  • L’elenco a discesa Start della temporizzazione di PowerPoint corrisponde alla proprietà Effect.Timing.TriggerType.
  • La Duration della temporizzazione di PowerPoint corrisponde alla proprietà Effect.Timing.Duration. La durata di un’animazione (in secondi) è il tempo totale necessario perché l’animazione completi un ciclo.
  • Il Delay della temporizzazione di PowerPoint corrisponde alla proprietà Effect.Timing.TriggerDelayTime.

Ecco come modificare le proprietà di temporizzazione dell’effetto:

  1. Applica o ottieni l’effetto di animazione.
  2. Imposta nuovi valori per le proprietà Effect.Timing necessarie.
  3. Salva il file PPTX modificato.

Questo codice Python dimostra l’operazione:

import aspose.slides as slides

# Istanzia una classe di presentazione che rappresenta un file di presentazione.
with slides.Presentation("AnimExample_out.pptx") as pres:
    # Ottiene la sequenza principale della slide.
    sequence = pres.slides[0].timeline.main_sequence

    # Ottiene il primo effetto della sequenza principale.
    effect = sequence[0]

    # Modifica il TriggerType dell'effetto per avviare al clic
    effect.timing.trigger_type = slides.animation.EffectTriggerType.ON_CLICK

    # Modifica la Durata dell'effetto
    effect.timing.duration = 3

    # Modifica il TriggerDelayTime dell'effetto
    effect.timing.trigger_delay_time = 0.5

    # Salva il file PPTX su disco
    pres.save("AnimExample_changed.pptx", slides.export.SaveFormat.PPTX)

Suono dell’effetto di animazione

Aspose.Slides fornisce queste proprietà per consentire di lavorare con i suoni negli effetti di animazione:

  • sound
  • stop_previous_sound

Aggiungere suono all’effetto di animazione

Questo codice Python mostra come aggiungere un suono a un effetto di animazione e fermarlo quando inizia il prossimo effetto:

import aspose.slides as slides

with Presentation("AnimExample_out.pptx") as pres:
    # Aggiunge audio alla raccolta audio della presentazione
    effect_sound = pres.audios.add_audio(open("sampleaudio.wav", "rb").read())

    first_slide = pres.slides[0]

    # Ottiene la sequenza principale della slide.
    sequence = first_slide.timeline.main_sequence

    # Ottiene il primo effetto della sequenza principale
    first_effect = sequence[0]

    # Verifica l'effetto per "No Sound"
    if not first_effect.stop_previous_sound and first_effect.sound is None:
        # Aggiunge suono per il primo effetto
        first_effect.sound = effect_sound

    # Ottiene la prima sequenza interattiva della slide.
    interactive_sequence = first_slide.timeline.interactive_sequences[0]

    # Imposta il flag "Stop previous sound" dell'effetto
    interactive_sequence[0].stop_previous_sound = True

    # Scrive il file PPTX su disco
    pres.save("AnimExample_Sound_out.pptx", slides.export.SaveFormat.PPTX)

Estrarre suono dall’effetto di animazione

  1. Crea un’istanza della classe Presentation.
  2. Ottieni un riferimento alla slide tramite il suo indice.
  3. Ottieni la sequenza principale di effetti.
  4. Estrai il sound incorporato in ciascun effetto di animazione.

Questo codice Python mostra come estrarre il suono incorporato in un effetto di animazione:

import aspose.slides as slides

# Istanzia una classe di presentazione che rappresenta un file di presentazione.
with slides.Presentation("EffectSound.pptx") as presentation:
    slide = presentation.slides[0]

    # Ottiene la sequenza principale della slide.
    sequence = slide.timeline.main_sequence

    for effect in sequence:
        if effect.sound is None:
            continue

        # Estrae il suono dell'effetto in un array di byte
        audio = effect.sound.binary_data

Dopo l’animazione

Aspose.Slides per .NET consente di modificare la proprietà After animation di un effetto di animazione.

Pannello dell’effetto di animazione dopo (After)

L’elenco a discesa After animation dell’effetto PowerPoint corrisponde a queste proprietà:

  • la proprietà after_animation_type che descrive il tipo di After animation :
    • PowerPoint More Colors corrisponde al tipo COLOR;
    • PowerPoint Don’t Dim corrisponde al tipo DO_NOT_DIM (tipo di after animation predefinito);
    • PowerPoint Hide After Animation corrisponde al tipo HIDE_AFTER_ANIMATION;
    • PowerPoint Hide on Next Mouse Click corrisponde al tipo HIDE_ON_NEXT_MOUSE_CLICK;
  • la proprietà after_animation_color che definisce il formato del colore after animation. Questa proprietà funziona in combinazione con il tipo COLOR. Se cambi il tipo con un altro, il colore after animation verrà cancellato.

Questo codice Python mostra come modificare un effetto after animation:

import aspose.slides as slides

# Istanzia una classe di presentazione che rappresenta un file di presentazione
with slides.Presentation("AnimImage_out.pptx") as pres:
    first_slide = pres.slides[0]

    # Ottiene il primo effetto della sequenza principale
    first_effect = first_slide.timeline.main_sequence[0]

    # Imposta il tipo di after animation su Color
    first_effect.after_animation_type = AfterAnimationType.COLOR

    # Imposta il colore di dim dell'after animation
    first_effect.after_animation_color.color = Color.alice_blue

    # Scrive il file PPTX su disco
    pres.save("AnimImage_AfterAnimation.pptx", slides.export.SaveFormat.PPTX)

Animare il testo

Aspose.Slides fornisce queste proprietà per consentire di lavorare con il blocco Animate text di un effetto di animazione:

  • animate_text_type che descrive il tipo di animazione del testo dell’effetto. Il testo della forma può essere animato:
  • delay_between_text_parts imposta un ritardo tra le parti di testo animate (parole o lettere). Un valore positivo specifica la percentuale della durata dell’effetto. Un valore negativo specifica il ritardo in secondi.

Ecco come è possibile modificare le proprietà Animate text dell’effetto:

  1. Applica o ottieni l’effetto di animazione.
  2. Imposta la proprietà build_type al valore AS_ONE_OBJECT per disattivare la modalità di animazione By Paragraphs.
  3. Imposta nuovi valori per le proprietà animate_text_type e delay_between_text_parts.
  4. Salva il file PPTX modificato.

Questo codice Python dimostra l’operazione:

import aspose.slides as slides

with slides.Presentation("AnimTextBox_out.pptx") as pres:
    first_slide = pres.slides[0]

    # Ottiene il primo effetto della sequenza principale
    first_effect = first_slide.timeline.main_sequence[0]

    # Modifica il tipo di animazione del testo dell'effetto a "As One Object"
    first_effect.text_animation.build_type = slides.animation.BuildType.AS_ONE_OBJECT

    # Modifica il tipo di animazione del testo dell'effetto a "By word"
    first_effect.animate_text_type = slides.animation.AnimateTextType.BY_WORD

    # Imposta il ritardo tra le parole al 20% della durata dell'effetto
    first_effect.delay_between_text_parts = 20

    # Scrive il file PPTX su disco
    pres.save("AnimTextBox_AnimateText.pptx", slides.export.SaveFormat.PPTX)

FAQ

Come posso assicurarmi che le animazioni siano preservate durante la pubblicazione della presentazione sul web?

Export to HTML5 e abilita le opzioni responsabili delle animazioni di shape e di transition. L’HTML semplice non riproduce le animazioni delle slide, mentre l’HTML5 lo fa.

Come influisce la modifica dell’ordine Z (ordine dei livelli) delle forme sull’animazione?

L’animazione e l’ordine di disegno sono indipendenti: un effetto controlla la temporizzazione e il tipo di apparizione/scomparsa, mentre z-order determina cosa copre cosa. Il risultato visibile è definito dalla loro combinazione. (Questo è il comportamento generale di PowerPoint; il modello effetti‑e‑forme di Aspose.Slides segue la stessa logica.)

Ci sono limitazioni nella conversione delle animazioni in video per alcuni effetti?

In generale, le animazioni sono supportate, ma in alcuni casi rari o per effetti specifici potrebbero essere renderizzate diversamente. Si consiglia di testare con gli effetti utilizzati e con la versione della libreria.

Ottieni le proprietà efficaci delle forme dalle presentazioni con Python Crea Miniature delle Forme di Presentazione in Python