Applicare animazioni di forme nelle presentazioni usando Java

Introduzione

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

Perché usare le animazioni nelle presentazioni?

Usando le animazioni, puoi

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
attirare l’attenzione dei lettori o spettatori alle parti importanti di una presentazione

PowerPoint offre molte opzioni e strumenti per animazioni ed effetti di animazione nelle categorie entrance, exit, emphasis e motion paths.

Animazioni in Aspose.Slides

Aspose.Slides fornisce le classi e i tipi necessari per lavorare con le animazioni nello spazio dei nomi Aspose.Slides.Animation,
Aspose.Slides fornisce oltre 150 effetti di animazione nell’enumerazione EffectType. Questi effetti sono essenzialmente gli stessi (o equivalenti) effetti utilizzati in PowerPoint.

Applicare animazione a una casella di testo

Aspose.Slides per Java consente di applicare animazione al testo in una forma.

Crea un’istanza della classe Presentation.
Ottieni un riferimento a una diapositiva tramite il suo indice.
Aggiungi un rectangle IAutoShape.
Aggiungi testo a IAutoShape.TextFrame.
Ottieni la sequenza principale di effetti.
Aggiungi un effetto di animazione a IAutoShape.
Imposta la proprietà TextAnimation.BuildType al valore dell’enumerazione BuildType.
Scrivi la presentazione su disco come file PPTX.

Questo codice Java mostra come applicare l’effetto Fade a AutoShape e impostare l’animazione del testo sul valore Per paragrafi di primo livello:

// Istanzia una classe di presentazione che rappresenta un file di presentazione.
Presentation pres = new Presentation();
try {
    ISlide sld = pres.getSlides().get_Item(0);

    // Aggiunge una nuova AutoShape con testo
    IAutoShape autoShape = sld.getShapes().addAutoShape(ShapeType.Rectangle, 20, 20, 150, 100);

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

    // Ottiene la sequenza principale della diapositiva.
    ISequence sequence = sld.getTimeline().getMainSequence();

    // Aggiunge l'effetto di animazione Fade alla forma
    IEffect effect = sequence.addEffect(autoShape, EffectType.Fade, EffectSubtype.None, EffectTriggerType.OnClick);

    // Anima il testo della forma per paragrafi di primo livello
    effect.getTextAnimation().setBuildType(BuildType.ByLevelParagraphs1);

    // Salva il file PPTX su disco
    pres.save(path + "AnimText_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Oltre ad applicare animazioni al testo, è possibile applicare animazioni a un singolo Paragraph. Vedi Testo animato.

Applicare animazione a un PictureFrame

Crea un’istanza della classe Presentation.
Ottieni un riferimento a una diapositiva tramite il suo indice.
Aggiungi o ottieni un PictureFrame nella diapositiva.
Ottieni la sequenza principale di effetti.
Aggiungi un effetto di animazione a PictureFrame.
Scrivi la presentazione su disco come file PPTX.

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

// Istanzia una classe di presentazione che rappresenta un file di presentazione.
Presentation pres = new Presentation();
try {
    // Carica l'immagine da aggiungere nella collezione di immagini della presentazione
    IPPImage picture;
    IImage image = Images.fromFile("aspose-logo.jpg");
    try {
        picture = pres.getImages().addImage(image);
    } finally {
        if (image != null) image.dispose();
    }

    // Aggiunge picture frame alla diapositiva
    IPictureFrame picFrame = pres.getSlides().get_Item(0).getShapes().addPictureFrame(ShapeType.Rectangle, 50, 50, 100, 100, picture);

    // Ottiene la sequenza principale della diapositiva.
    ISequence sequence = pres.getSlides().get_Item(0).getTimeline().getMainSequence();

    // Aggiunge l'effetto di animazione Fly da sinistra al picture frame
    IEffect effect = sequence.addEffect(picFrame, EffectType.Fly, EffectSubtype.Left, EffectTriggerType.OnClick);

    // Salva il file PPTX su disco
    pres.save(path + "AnimImage_out.pptx", SaveFormat.Pptx);
} catch(IOException e) {
} finally {
    if (pres != null) pres.dispose();
}

Applicare animazione a una forma

Crea un’istanza della classe Presentation.
Ottieni un riferimento a una diapositiva tramite il suo indice.
Aggiungi un rectangle IAutoShape.
Aggiungi un Bevel IAutoShape (quando questo oggetto viene cliccato, l’animazione viene riprodotta).
Crea una sequenza di effetti sulla forma bevel.
Crea un UserPath personalizzato.
Aggiungi comandi per spostarsi al UserPath.
Scrivi la presentazione su disco come file PPTX.

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

// Istanzia una classe Presentation che rappresenta un file PPTX.
Presentation pres = new Presentation();
try {
    ISlide sld = pres.getSlides().get_Item(0);

    // Crea l'effetto PathFootball per la forma esistente da zero.
    IAutoShape ashp = sld.getShapes().addAutoShape(ShapeType.Rectangle, 150, 150, 250, 25);
    ashp.addTextFrame("Animated TextBox");

    // Aggiunge l'effetto di animazione PathFootBall
    pres.getSlides().get_Item(0).getTimeline().getMainSequence().addEffect(ashp, EffectType.PathFootball,
            EffectSubtype.None, EffectTriggerType.AfterPrevious);

    // Crea una sorta di "pulsante".
    IShape shapeTrigger = pres.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Bevel, 10, 10, 20, 20);

    // Crea una sequenza di effetti per questo pulsante.
    ISequence seqInter = pres.getSlides().get_Item(0).getTimeline().getInteractiveSequences().add(shapeTrigger);

     // Crea un percorso utente personalizzato. Il nostro oggetto verrà spostato solo dopo che il pulsante è stato cliccato.
    IEffect fxUserPath = seqInter.addEffect(ashp, EffectType.PathUser, EffectSubtype.None, EffectTriggerType.OnClick);

     // Aggiunge comandi per lo spostamento poiché il percorso creato è vuoto.
    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);

     // Scrive il file PPTX su disco
    pres.save("AnimExample_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Ottenere gli effetti di animazione applicati a una forma

Gli esempi seguenti mostrano come utilizzare il metodo getEffectsByShape dell’interfaccia ISequence per ottenere tutti gli effetti di animazione applicati a una forma.

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

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

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

    // Ottiene la sequenza principale di animazione della diapositiva.
    ISequence sequence = firstSlide.getTimeline().getMainSequence();

    // Ottiene la prima forma sulla prima diapositiva.
    IShape shape = firstSlide.getShapes().get_Item(0);

    // Ottiene gli effetti di animazione applicati alla forma.
    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();
}

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

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

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

Effetto animazione forma della diapositiva

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

Effetto animazione forma del layout

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

Effetto animazione forma del master

Il codice di esempio seguente mostra come utilizzare il metodo getBasePlaceholder dell’interfaccia IShape per accedere ai segnaposti della forma e ottenere gli effetti di animazione applicati alla forma piè di pagina, inclusi quelli ereditati dai segnaposti presenti su layout e master.

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

Modificare le proprietà di timing dell’effetto di animazione

Aspose.Slides per Java consente di modificare le proprietà di Timing di un effetto di animazione.

Questa è la finestra Timing dell’animazione in Microsoft PowerPoint:

immagine esempio1

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

PowerPoint Timing Start corrisponde alla proprietà Effect.Timing.TriggerType.
PowerPoint Timing Duration corrisponde alla proprietà Effect.Timing.Duration. La durata di un’animazione (in secondi) è il tempo totale necessario per completare un ciclo.
PowerPoint Timing Delay corrisponde alla proprietà Effect.Timing.TriggerDelayTime.

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

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

Questo codice Java dimostra l’operazione:

// Istanzia una classe di presentazione che rappresenta un file di presentazione.
Presentation pres = new Presentation("AnimExample_out.pptx");
try {
    // Ottiene la sequenza principale della diapositiva.
    ISequence sequence = pres.getSlides().get_Item(0).getTimeline().getMainSequence();

    // Ottiene il primo effetto della sequenza principale.
    IEffect effect = sequence.get_Item(0);

    // Modifica il TriggerType dell'effetto per avviarlo al clic
    effect.getTiming().setTriggerType(EffectTriggerType.OnClick);

    // Modifica la Durata dell'effetto
    effect.getTiming().setDuration(3f);

    // Modifica il TriggerDelayTime dell'effetto
    effect.getTiming().setTriggerDelayTime(0.5f);

    // Salva il file PPTX su disco
    pres.save("AnimExample_changed.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Suono dell’effetto di animazione

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

Aggiungere un suono all’effetto di animazione

Questo codice Java mostra come aggiungere un suono a un effetto di animazione e fermarlo quando inizia l’effetto successivo:

Presentation pres = new Presentation("AnimExample_out.pptx");
try {
    // Aggiunge audio alla raccolta audio della presentazione
    IAudio effectSound = pres.getAudios().addAudio(Files.readAllBytes(Paths.get("sampleaudio.wav")));

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

    // Ottiene la sequenza principale della diapositiva.
    ISequence sequence = firstSlide.getTimeline().getMainSequence();

    // Ottiene il primo effetto della sequenza principale
    IEffect firstEffect = sequence.get_Item(0);

    // Verifica se l'effetto non ha suono
    if (!firstEffect.getStopPreviousSound() && firstEffect.getSound() == null)
    {
        // Aggiunge suono al primo effetto
        firstEffect.setSound(effectSound);
    }

    // Ottiene la prima sequenza interattiva della diapositiva.
    ISequence interactiveSequence = firstSlide.getTimeline().getInteractiveSequences().get_Item(0);

    // Imposta il flag "Stop previous sound" dell'effetto
    interactiveSequence.get_Item(0).setStopPreviousSound(true);

    // Scrive il file PPTX su disco
    pres.save("AnimExample_Sound_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Estrarre un suono dall’effetto di animazione

Crea un’istanza della classe Presentation .
Ottieni un riferimento a una diapositiva tramite il suo indice.
Ottieni la sequenza principale di effetti.
Estrai il valore setSound(IAudio value) incorporato in ciascun effetto di animazione.

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

// Istanzia una classe di presentazione che rappresenta un file di presentazione.
Presentation presentation = new Presentation("EffectSound.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    // Ottiene la sequenza principale della diapositiva.
    ISequence sequence = slide.getTimeline().getMainSequence();

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

        // Estrae il suono dell'effetto in un array di byte
        byte[] audio = effect.getSound().getBinaryData();
    }
} finally {
    if (presentation != null) presentation.dispose();
}

Dopo l’animazione

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

Questa è la finestra dell’effetto di animazione e il menu esteso in Microsoft PowerPoint:

immagine esempio1

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

setAfterAnimationType(int value) descrive il tipo di After animation :
- PowerPoint More Colors corrisponde al tipo AfterAnimationType.Color;
- PowerPoint Don’t Dim corrisponde al tipo AfterAnimationType.DoNotDim (tipo predefinito);
- PowerPoint Hide After Animation corrisponde al tipo AfterAnimationType.HideAfterAnimation;
- PowerPoint Hide on Next Mouse Click corrisponde al tipo AfterAnimationType.HideOnNextMouseClick;
setAfterAnimationColor(IColorFormat value) definisce un formato colore After animation. Questa proprietà funziona in combinazione con il tipo AfterAnimationType.Color. Se cambi il tipo, il colore After animation verrà cancellato.

Questo codice Java mostra come modificare un effetto After animation:

// Istanzia una classe di presentazione che rappresenta un file di presentazione
Presentation pres = new Presentation("AnimImage_out.pptx");
try {
    ISlide firstSlide = pres.getSlides().get_Item(0);

    // Ottiene il primo effetto della sequenza principale
    IEffect firstEffect = firstSlide.getTimeline().getMainSequence().get_Item(0);

    // Cambia il tipo di after animation a Color
    firstEffect.setAfterAnimationType(AfterAnimationType.Color);

    // Imposta il colore di attenuazione after animation
    firstEffect.getAfterAnimationColor().setColor(Color.BLUE);

    // Scrive il file PPTX su disco
    pres.save("AnimImage_AfterAnimation.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Animare il testo

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

setAnimateTextType(int value) descrive il tipo di animazione del testo dell’effetto. Il testo della forma può essere animato:
- Tutto in una volta (AnimateTextType.AllAtOnce)
- Per parola (AnimateTextType.ByWord)
- Per lettera (AnimateTextType.ByLetter)
setDelayBetweenTextParts(float value) imposta un ritardo tra le parti di testo animate (parole o lettere). Un valore positivo indica la percentuale della durata dell’effetto. Un valore negativo indica il ritardo in secondi.

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

Apply o ottieni l’effetto di animazione.
Imposta la proprietà setBuildType(int value) su BuildType.AsOneObject per disattivare la modalità By Paragraphs.
Imposta nuovi valori per le proprietà setAnimateTextType(int value) e setDelayBetweenTextParts(float value).
Salva il file PPTX modificato.

Questo codice Java dimostra l’operazione:

// Istanzia una classe di presentazione che rappresenta un file di presentazione.
Presentation pres = new Presentation("AnimTextBox_out.pptx");
try {
    ISlide firstSlide = pres.getSlides().get_Item(0);

    // Ottiene il primo effetto della sequenza principale
    IEffect firstEffect = firstSlide.getTimeline().getMainSequence().get_Item(0);

    // Cambia il tipo di animazione del testo dell'effetto a "As One Object"
    firstEffect.getTextAnimation().setBuildType(BuildType.AsOneObject);

    // Cambia il tipo di animazione del testo dell'effetto a "By word"
    firstEffect.setAnimateTextType(AnimateTextType.ByWord);

    // Imposta il ritardo tra le parole al 20% della durata dell'effetto
    firstEffect.setDelayBetweenTextParts(20f);

    // Scrive il file PPTX su disco
    pres.save("AnimTextBox_AnimateText.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

FAQ

Come posso garantire che le animazioni vengano preservate durante la pubblicazione della presentazione sul web?

Esporta a HTML5 e abilita le options responsabili delle animazioni di shape e di transition. L’HTML normale non riproduce le animazioni delle diapositive, mentre l’HTML5 lo fa.

In che modo la modifica dell’ordine z (ordine dei livelli) delle forme influisce sull’animazione?

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

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

In generale, animations are supported, ma casi rari o effetti specifici potrebbero essere renderizzati diversamente. Si consiglia di testare con gli effetti utilizzati e con la versione della libreria.

Ottenere le proprietà effettive della forma dalle presentazioni in Java Crea miniature di forme di presentazione in Java