Aplicar animações de formas em apresentações usando JavaScript

Introdução

Animações são efeitos visuais que podem ser aplicados a textos, imagens, formas ou gráficos. Elas dão vida a apresentações ou seus componentes.

Por que usar animações em apresentações?

controlar o fluxo de informações
enfatizar pontos importantes
aumentar o interesse ou a participação do seu público
tornar o conteúdo mais fácil de ler, assimilar ou processar
chamar a atenção de seus leitores ou espectadores para partes importantes em uma apresentação

O PowerPoint oferece muitas opções e ferramentas para animações e efeitos de animação nas categorias de entrada, saída, ênfase e caminhos de movimento.

Animações no Aspose.Slides

Aspose.Slides fornece as classes e tipos que você precisa para trabalhar com animações no namespace Aspose.Slides.Animation,
Aspose.Slides oferece mais de 150 efeitos de animação na enumeração EffectType. Esses efeitos são essencialmente os mesmos (ou equivalentes) usados no PowerPoint.

Aplicar animação a TextBox

Aspose.Slides para Node.js via Java permite que você aplique animação ao texto em uma forma.

Crie uma instância da classe Presentation.
Obtenha uma referência ao slide através de seu índice.
Adicione um rectangle AutoShape.
Adicione texto usando AutoShape.addTextFrame.
Obtenha a sequência principal de efeitos.
Adicione um efeito de animação ao AutoShape.
Chame o método TextAnimation.setBuildType com o valor da enumeração BuildType.
Grave a apresentação no disco como um arquivo PPTX.

Este código Javascript mostra como aplicar o efeito Fade ao AutoShape e definir a animação de texto para o valor By 1st Level Paragraphs:

// Instancia uma classe de apresentação que representa um arquivo de apresentação.
var pres = new aspose.slides.Presentation();
try {
    var sld = pres.getSlides().get_Item(0);
    // Adiciona um novo AutoShape com texto
    var autoShape = sld.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 20, 20, 150, 100);
    var textFrame = autoShape.getTextFrame();
    textFrame.setText("First paragraph \nSecond paragraph \n Third paragraph");
    // Obtém a sequência principal do slide.
    var sequence = sld.getTimeline().getMainSequence();
    // Adiciona o efeito de animação Fade à forma
    var effect = sequence.addEffect(autoShape, aspose.slides.EffectType.Fade, aspose.slides.EffectSubtype.None, aspose.slides.EffectTriggerType.OnClick);
    // Anima o texto da forma por parágrafos de primeiro nível
    effect.getTextAnimation().setBuildType(aspose.slides.BuildType.ByLevelParagraphs1);
    // Salva o arquivo PPTX no disco
    pres.save(path + "AnimText_out.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

Além de aplicar animações ao texto, você também pode aplicar animações a um único Paragraph. Consulte Animated Text.

Aplicar animação a PictureFrame

Crie uma instância da classe Presentation.
Obtenha a referência de um slide através de seu índice.
Adicione ou obtenha um PictureFrame no slide.
Obtenha a sequência principal de efeitos.
Adicione um efeito de animação ao PictureFrame.
Grave a apresentação no disco como um arquivo PPTX.

Este código Javascript mostra como aplicar o efeito Fly a um quadro de imagem:

// Instancia uma classe de apresentação que representa um arquivo de apresentação.
var pres = new aspose.slides.Presentation();
try {
    // Carrega a imagem a ser adicionada à coleção de imagens da apresentação
    var picture;
    var image = aspose.slides.Images.fromFile("aspose-logo.jpg");
    try {
        picture = pres.getImages().addImage(image);
    } finally {
        if (image != null) {
            image.dispose();
        }
    }
    // Adiciona um quadro de imagem ao slide
    var picFrame = pres.getSlides().get_Item(0).getShapes().addPictureFrame(aspose.slides.ShapeType.Rectangle, 50, 50, 100, 100, picture);
    // Obtém a sequência principal do slide.
    var sequence = pres.getSlides().get_Item(0).getTimeline().getMainSequence();
    // Adiciona o efeito de animação Fly de esquerda para o quadro de imagem
    var effect = sequence.addEffect(picFrame, aspose.slides.EffectType.Fly, aspose.slides.EffectSubtype.Left, aspose.slides.EffectTriggerType.OnClick);
    // Salva o arquivo PPTX no disco
    pres.save(path + "AnimImage_out.pptx", aspose.slides.SaveFormat.Pptx);
} catch (e) {console.log(e);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

Aplicar animação a Shape

Crie uma instância da classe Presentation.
Obtenha a referência de um slide através de seu índice.
Adicione um rectangle AutoShape.
Adicione um Bevel AutoShape (quando este objeto for clicado, a animação será reproduzida).
Crie uma sequência de efeitos na forma bevel.
Crie um UserPath personalizado.
Adicione comandos para mover ao UserPath.
Grave a apresentação no disco como um arquivo PPTX.

Este código Javascript mostra como aplicar o efeito PathFootball (caminho futebol) a uma forma:

// Instancia uma classe Presentation que representa um arquivo PPTX.
var pres = new aspose.slides.Presentation();
try {
    var sld = pres.getSlides().get_Item(0);
    // Cria o efeito PathFootball para a forma existente do zero.
    var ashp = sld.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 150, 150, 250, 25);
    ashp.addTextFrame("Animated TextBox");
    // Adiciona o efeito de animação PathFootBall
    pres.getSlides().get_Item(0).getTimeline().getMainSequence().addEffect(ashp, aspose.slides.EffectType.PathFootball, aspose.slides.EffectSubtype.None, aspose.slides.EffectTriggerType.AfterPrevious);
    // Cria uma espécie de "botão".
    var shapeTrigger = pres.getSlides().get_Item(0).getShapes().addAutoShape(aspose.slides.ShapeType.Bevel, 10, 10, 20, 20);
    // Cria uma sequência de efeitos para este botão.
    var seqInter = pres.getSlides().get_Item(0).getTimeline().getInteractiveSequences().add(shapeTrigger);
    // Cria um caminho de usuário personalizado. Nosso objeto será movido somente após o botão ser clicado.
    var fxUserPath = seqInter.addEffect(ashp, aspose.slides.EffectType.PathUser, aspose.slides.EffectSubtype.None, aspose.slides.EffectTriggerType.OnClick);
    // Adiciona comandos de movimentação já que o caminho criado está vazio.
    var motionBhv = fxUserPath.getBehaviors().get_Item(0);
    var pts = java.newArray("com.aspose.slides.Point2DFloat", [java.newInstanceSync("com.aspose.slides.Point2DFloat", 0.076, 0.59)]);
    motionBhv.getPath().add(aspose.slides.MotionCommandPathType.LineTo, pts, aspose.slides.MotionPathPointsType.Auto, true);
    pts[0] = java.newInstanceSync("com.aspose.slides.Point2DFloat", java.newFloat(-0.076), java.newFloat(-0.59));
    motionBhv.getPath().add(aspose.slides.MotionCommandPathType.LineTo, pts, aspose.slides.MotionPathPointsType.Auto, false);
    motionBhv.getPath().add(aspose.slides.MotionCommandPathType.End, null, aspose.slides.MotionPathPointsType.Auto, false);
    // Grava o arquivo PPTX no disco
    pres.save("AnimExample_out.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

Obter os efeitos de animação aplicados à Shape

Os exemplos a seguir mostram como usar o método getEffectsByShape da classe Sequence para obter todos os efeitos de animação aplicados a uma forma.

Exemplo 1: Obter efeitos de animação aplicados a uma forma em um slide normal

Anteriormente, você aprendeu como adicionar efeitos de animação a formas em apresentações do PowerPoint. O código de exemplo a seguir mostra como obter os efeitos aplicados à primeira forma no primeiro slide normal da apresentação AnimExample_out.pptx.

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

    // Obtém a sequência principal de animação do slide.
    var sequence = firstSlide.getTimeline().getMainSequence();

    // Obtém a primeira forma no primeiro slide.
    var shape = firstSlide.getShapes().get_Item(0);

    // Obtém os efeitos de animação aplicados à forma.
    var shapeEffects = sequence.getEffectsByShape(shape);

    if (shapeEffects.length > 0) {
        console.log("The shape", shape.getName(), "has", shapeEffects.length, "animation effects.");
    }
} finally {
    if (presentation != null) {
        presentation.dispose();
    }
}

Exemplo 2: Obter todos os efeitos de animação, incluindo os herdados de placeholders

Se uma forma em um slide normal contém espaços reservados que estão no slide de layout e/ou no slide mestre, e efeitos de animação foram adicionados a esses espaços reservados, então todos os efeitos da forma serão reproduzidos durante a apresentação, incluindo os herdados dos espaços reservados.

Suponha que temos um arquivo de apresentação PowerPoint sample.pptx com um slide contendo apenas uma forma de rodapé com o texto “Made with Aspose.Slides” e o efeito Random Bars está aplicado à forma.

Slide shape animation effect

Vamos também supor que o efeito Split está aplicado ao espaço reservado de rodapé no slide de layout.

Layout shape animation effect

E, finalmente, o efeito Fly In está aplicado ao espaço reservado de rodapé no slide master.

Master shape animation effect

O código de exemplo a seguir mostra como usar o método getBasePlaceholder da classe Shape para acessar os espaços reservados de forma e obter os efeitos de animação aplicados à forma de rodapé, incluindo os herdados dos espaços reservados localizados nos slides de layout e mestre.

var presentation = new aspose.slides.Presentation("sample.pptx");

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

// Obtém os efeitos de animação da forma no slide normal.
var shape = slide.getShapes().get_Item(0);
var shapeEffects = slide.getTimeline().getMainSequence().getEffectsByShape(shape);

// Obtém os efeitos de animação do placeholder no slide de layout.
var layoutShape = shape.getBasePlaceholder();
var layoutShapeEffects = slide.getLayoutSlide().getTimeline().getMainSequence().getEffectsByShape(layoutShape);

// Obtém os efeitos de animação do placeholder no slide mestre.
var masterShape = layoutShape.getBasePlaceholder();
var masterShapeEffects = slide.getLayoutSlide().getMasterSlide().getTimeline().getMainSequence().getEffectsByShape(masterShape);

console.log("Main sequence of shape effects:");
printEffects(masterShapeEffects);
printEffects(layoutShapeEffects);
printEffects(shapeEffects);

presentation.dispose();

function printEffects(effects) {
    for (const effect of effects) {
        console.log("Type:", effect.getType() + ", subtype:", effect.getSubtype());
    }
}

Main sequence of shape effects:
Type: 47, subtype: 2              // Voo, Inferior
Type: 134, subtype: 45            // Dividir, VerticalIn
Type: 126, subtype: 22            // Barras aleatórias, Horizontal

Alterar propriedades de temporização do efeito de animação

Aspose.Slides para Node.js via Java permite que você altere as propriedades de temporização de um efeito de animação.

Este é o painel de temporização de animação no Microsoft PowerPoint:

example1_image

Estas são as correspondências entre a temporização do PowerPoint e as propriedades Effect.Timing:

O menu suspenso Start da temporização do PowerPoint corresponde à propriedade Effect.Timing.TriggerType.
O Duration da temporização do PowerPoint corresponde à propriedade Effect.Timing.Duration. A duração de uma animação (em segundos) é o tempo total que leva para a animação concluir um ciclo.
O Delay da temporização do PowerPoint corresponde à propriedade Effect.Timing.TriggerDelayTime.

É assim que você altera as propriedades de temporização do Effect:

Aplicar ou obter o efeito de animação.
Defina novos valores para as propriedades Effect.Timing necessárias.
Salve o arquivo PPTX modificado.

Este código Javascript demonstra a operação:

// Instancia uma classe de apresentação que representa um arquivo de apresentação.
var pres = new aspose.slides.Presentation("AnimExample_out.pptx");
try {
    // Obtém a sequência principal do slide.
    var sequence = pres.getSlides().get_Item(0).getTimeline().getMainSequence();
    // Obtém o primeiro efeito da sequência principal.
    var effect = sequence.get_Item(0);
    // Altera o TriggerType do efeito para iniciar ao clicar
    effect.getTiming().setTriggerType(aspose.slides.EffectTriggerType.OnClick);
    // Altera a Duração do efeito
    effect.getTiming().setDuration(3.0);
    // Altera o TriggerDelayTime do efeito
    effect.getTiming().setTriggerDelayTime(0.5);
    // Salva o arquivo PPTX no disco
    pres.save("AnimExample_changed.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

Som do efeito de animação

Aspose.Slides fornece estas propriedades para permitir trabalhar com sons em efeitos de animação:

Adicionar som ao efeito de animação

Este código Javascript mostra como adicionar um som ao efeito de animação e pará-lo quando o próximo efeito começar:

var pres = new aspose.slides.Presentation("AnimExample_out.pptx");
try {
    // Adiciona áudio à coleção de áudio da apresentação
    var effectSound = pres.getAudios().addAudio(java.newInstanceSync("java.io.FileInputStream", java.newInstanceSync("java.io.File", "sampleaudio.wav")));
    var firstSlide = pres.getSlides().get_Item(0);
    // Obtém a sequência principal do slide.
    var sequence = firstSlide.getTimeline().getMainSequence();
    // Obtém o primeiro efeito da sequência principal
    var firstEffect = sequence.get_Item(0);
    // Verifica se o efeito está sem som
    if ((!firstEffect.getStopPreviousSound()) && (firstEffect.getSound() == null)) {
        // Adiciona som ao primeiro efeito
        firstEffect.setSound(effectSound);
    }
    // Obtém a primeira sequência interativa do slide.
    var interactiveSequence = firstSlide.getTimeline().getInteractiveSequences().get_Item(0);
    // Define a flag "Stop previous sound" do efeito
    interactiveSequence.get_Item(0).setStopPreviousSound(true);
    // Grava o arquivo PPTX no disco
    pres.save("AnimExample_Sound_out.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

Extrair som do efeito de animação

Crie uma instância da classe Presentation.
Obtenha a referência de um slide através de seu índice.
Obtenha a sequência principal de efeitos.
Extraia o setSound(IAudio value) incorporado a cada efeito de animação.

Este código Javascript mostra como extrair o som incorporado em um efeito de animação:

// Instancia uma classe de apresentação que representa um arquivo de apresentação.
var presentation = new aspose.slides.Presentation("EffectSound.pptx");
try {
    var slide = presentation.getSlides().get_Item(0);
    // Obtém a sequência principal do slide.
    var sequence = slide.getTimeline().getMainSequence();
    for (var i = 0; i < sequence.getCount(); i++) {
        var effect = sequence.get_Item(i);
        if (effect.getSound() == null) {
            continue;
        }
        // Extrai o som do efeito em um array de bytes
        var audio = effect.getSound().getBinaryData();
    }
} finally {
    if (presentation != null) {
        presentation.dispose();
    }
}

Após a animação

Aspose.Slides para Node.js via Java permite que você altere a propriedade After animation de um efeito de animação.

Este é o painel de Efeito de Animação e o menu estendido no Microsoft PowerPoint:

example1_image

A lista suspensa After animation do efeito PowerPoint corresponde a estas propriedades:

O método setAfterAnimationType(int value) que descreve o tipo After animation;
- O More Colors do PowerPoint corresponde ao tipo AfterAnimationType.Color;
- O item Don’t Dim do PowerPoint corresponde ao tipo AfterAnimationType.DoNotDim (tipo padrão de After animation);
- O item Hide After Animation do PowerPoint corresponde ao tipo AfterAnimationType.HideAfterAnimation;
- O item Hide on Next Mouse Click do PowerPoint corresponde ao tipo AfterAnimationType.HideOnNextMouseClick;
O método setAfterAnimationColor(IColorFormat value) que define um formato de cor de after animation. Este método funciona em conjunto com o tipo AfterAnimationType.Color. Se você mudar o tipo para outro, a cor after animation será limpa.

Este código Javascript mostra como alterar um efeito de after animation:

// Instancia uma classe de apresentação que representa um arquivo de apresentação
var pres = new aspose.slides.Presentation("AnimImage_out.pptx");
try {
    var firstSlide = pres.getSlides().get_Item(0);
    // Obtém o primeiro efeito da sequência principal
    var firstEffect = firstSlide.getTimeline().getMainSequence().get_Item(0);
    // Altera o tipo de after animation para Cor
    firstEffect.setAfterAnimationType(aspose.slides.AfterAnimationType.Color);
    // Define a cor de after animation
    firstEffect.getAfterAnimationColor().setColor(java.getStaticFieldValue("java.awt.Color", "BLUE"));
    // Grava o arquivo PPTX no disco
    pres.save("AnimImage_AfterAnimation.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

Animar texto

Aspose.Slides fornece estas propriedades para permitir trabalhar com o bloco Animate text de um efeito de animação:

setAnimateTextType(int value) que descreve o tipo de animação de texto do efeito. O texto da forma pode ser animado:
- Tudo de uma vez (AnimateTextType.AllAtOnce tipo)
- Por palavra (AnimateTextType.ByWord tipo)
- Por letra (AnimateTextType.ByLetter tipo)
setDelayBetweenTextParts(float value) define um atraso entre as partes de texto animadas (palavras ou letras). Um valor positivo especifica a porcentagem da duração do efeito. Um valor negativo especifica o atraso em segundos.

É assim que você pode alterar as propriedades Animate text do Effect:

Aplicar ou obter o efeito de animação.
Defina o método setBuildType(int value) para o valor BuildType.AsOneObject para desativar o modo de animação By Paragraphs.
Defina novos valores para as propriedades setAnimateTextType(int value) e setDelayBetweenTextParts(float value).
Salve o arquivo PPTX modificado.

Este código Javascript demonstra a operação:

// Instancia uma classe de apresentação que representa um arquivo de apresentação.
var pres = new aspose.slides.Presentation("AnimTextBox_out.pptx");
try {
    var firstSlide = pres.getSlides().get_Item(0);
    // Obtém o primeiro efeito da sequência principal
    var firstEffect = firstSlide.getTimeline().getMainSequence().get_Item(0);
    // Altera o tipo de animação de texto do efeito para "Como um objeto único"
    firstEffect.getTextAnimation().setBuildType(aspose.slides.BuildType.AsOneObject);
    // Altera o tipo de animação de texto do efeito para "Por palavra"
    firstEffect.setAnimateTextType(aspose.slides.AnimateTextType.ByWord);
    // Define o atraso entre palavras para 20% da duração do efeito
    firstEffect.setDelayBetweenTextParts(20.0);
    // Grava o arquivo PPTX no disco
    pres.save("AnimTextBox_AnimateText.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

FAQ

Como posso garantir que as animações sejam preservadas ao publicar a apresentação na web?

Export to HTML5 e habilite as options responsáveis por animações de shape e de transition. HTML simples não reproduz animações de slides, enquanto HTML5 reproduz.

Como a alteração da ordem Z (ordem das camadas) das formas afeta a animação?

A ordem de animação e a ordem de desenho são independentes: um efeito controla o tempo e o tipo de aparição/desaparecimento, enquanto a z-order determina o que cobre o quê. O resultado visível é definido pela combinação das duas. (Esse é o comportamento geral do PowerPoint; o modelo de efeitos e formas do Aspose.Slides segue a mesma lógica.)

Existem limitações ao converter animações para vídeo para certos efeitos?

Em geral, as animações são suportadas, mas casos raros ou efeitos específicos podem ser renderizados de forma diferente. Recomenda‑se testar com os efeitos que você usa e com a versão da biblioteca.

Obter propriedades efetivas de formas de apresentações em JavaScript Criar miniaturas de formas de apresentação em JavaScript