Aplicar animações de formas em apresentações no .NET

Introdução

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

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

Usando animações, você pode

• 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 de uma apresentação

PowerPoint fornece muitas opções e ferramentas para animações e efeitos de animação nas categorias 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 uma caixa de texto

Aspose.Slides para .NET permite aplicar animação ao texto em uma forma.

1. Crie uma instância da classe Presentation.
2. Obtenha uma referência ao slide através de seu índice.
3. Adicione um rectangle IAutoShape.
4. Adicione texto ao IAutoShape.TextFrame.
5. Obtenha uma sequência principal de efeitos.
6. Adicione um efeito de animação ao IAutoShape.
7. Defina a propriedade TextAnimation.BuildType para o valor da enumeração BuildType.
8. Grave a apresentação no disco como um arquivo PPTX.

// Instancia uma classe Presentation que representa um arquivo de apresentação.
using (Presentation pres = new Presentation())
{
    ISlide sld = pres.Slides[0];
    
    // Adiciona um novo AutoShape com texto
    IAutoShape autoShape = sld.Shapes.AddAutoShape(ShapeType.Rectangle, 20, 20, 150, 100);

    ITextFrame textFrame = autoShape.TextFrame;
    textFrame.Text = "First paragraph \nSecond paragraph \n Third paragraph";

    // Obtém a sequência principal do slide.
    ISequence sequence = sld.Timeline.MainSequence;

    // Adiciona efeito de animação Fade à forma
    IEffect effect = sequence.AddEffect(autoShape, EffectType.Fade, EffectSubtype.None, EffectTriggerType.OnClick);

    // Anima o texto da forma por parágrafos de 1º nível
    effect.TextAnimation.BuildType = BuildType.ByLevelParagraphs1;

    // Salva o arquivo PPTX no disco
    pres.Save(path + "AnimTextBox_out.pptx", SaveFormat.Pptx);
}

Além de aplicar animações ao texto, você também pode aplicar animações a um único Parágrafo. Veja Texto Animado.

Aplicar animação a um PictureFrame

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

 // Instancia uma classe de apresentação que representa um arquivo de apresentação.
 using (Presentation pres = new Presentation())
 {
     // Carrega a imagem a ser adicionada na coleção de imagens da apresentação
     IImage image = Images.FromFile("aspose-logo.jpg");
     IPPImage ppImage = pres.Images.AddImage(image);
     image.Dispose();

     // Adiciona quadro de imagem ao slide
     IPictureFrame picFrame = pres.Slides[0].Shapes.AddPictureFrame(ShapeType.Rectangle, 50, 50, 100, 100, ppImage);

     // Obtém a sequência principal do slide.
     ISequence sequence = pres.Slides[0].Timeline.MainSequence;

     // Adiciona efeito de animação Fly da esquerda ao quadro de imagem
     IEffect effect = sequence.AddEffect(picFrame, EffectType.Fly, EffectSubtype.Left, EffectTriggerType.OnClick);

     // Salva o arquivo PPTX no disco
     pres.Save("AnimImage_out.pptx", SaveFormat.Pptx);
 }

Aplicar animação a uma forma

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

 // Instancia uma classe Presentation que representa um arquivo de apresentação.
 using (Presentation pres = new Presentation())
 {
     ISlide sld = pres.Slides[0];

     // Cria o efeito PathFootball para a forma existente do zero.
     IAutoShape ashp = sld.Shapes.AddAutoShape(ShapeType.Rectangle, 150, 150, 250, 25);

     ashp.AddTextFrame("Animated TextBox");

     // Adiciona o efeito de animação PathFootball.
     pres.Slides[0].Timeline.MainSequence.AddEffect(ashp, EffectType.PathFootball,
                            EffectSubtype.None, EffectTriggerType.AfterPrevious);

     // Cria uma espécie de "botão".
     IShape shapeTrigger = pres.Slides[0].Shapes.AddAutoShape(ShapeType.Bevel, 10, 10, 20, 20);

     // Cria uma sequência de efeitos para o botão.
     ISequence seqInter = pres.Slides[0].Timeline.InteractiveSequences.Add(shapeTrigger);

     // Cria um caminho de usuário personalizado. Nosso objeto será movido somente após o botão ser clicado.
     IEffect fxUserPath = seqInter.AddEffect(ashp, EffectType.PathUser, EffectSubtype.None, EffectTriggerType.OnClick);

     // Adiciona comandos de movimentação já que o caminho criado está vazio.
     IMotionEffect motionBhv = ((IMotionEffect)fxUserPath.Behaviors[0]);

     PointF[] pts = new PointF[1];
     pts[0] = new PointF(0.076f, 0.59f);
     motionBhv.Path.Add(MotionCommandPathType.LineTo, pts, MotionPathPointsType.Auto, true);
     pts[0] = new PointF(-0.076f, -0.59f);
     motionBhv.Path.Add(MotionCommandPathType.LineTo, pts, MotionPathPointsType.Auto, false);
     motionBhv.Path.Add(MotionCommandPathType.End, null, MotionPathPointsType.Auto, false);

     // Grava o arquivo PPTX no disco
     pres.Save("AnimExample_out.pptx", SaveFormat.Pptx);
 }

Obter os efeitos de animação aplicados a uma forma

Os exemplos a seguir mostram como usar o método GetEffectsByShape da interface ISequence 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.

using (Presentation presentation = new Presentation("AnimExample_out.pptx"))
{
    ISlide firstSlide = presentation.Slides[0];

    // Obtém a sequência principal de animação do slide.
    ISequence sequence = firstSlide.Timeline.MainSequence;

    // Obtém a primeira forma no primeiro slide.
    IShape shape = firstSlide.Shapes[0];

    // Obtém os efeitos de animação aplicados à forma.
    IEffect[] shapeEffects = sequence.GetEffectsByShape(shape);

    if (shapeEffects.Length > 0)
        Console.WriteLine($"The shape {shape.Name} has {shapeEffects.Length} animation effects.");
}

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

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

Vamos supor 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 aplicado à forma.

Vamos também supor que o efeito Split está aplicado ao marcador de posição do rodapé no slide de layout.

E, por fim, o efeito Fly In está aplicado ao marcador de posição do rodapé no slide mestre.

O código de exemplo a seguir mostra como usar o método GetBasePlaceholder da interface IShape para acessar os marcadores de posição da forma e obter os efeitos de animação aplicados à forma de rodapé, incluindo os herdados dos marcadores localizados nos slides de layout e mestre.

using (Presentation presentation = new Presentation("sample.pptx"))
{
    ISlide slide = presentation.Slides[0];

    // Obtém os efeitos de animação da forma no slide normal.
    IShape shape = slide.Shapes[0];
    IEffect[] shapeEffects = slide.Timeline.MainSequence.GetEffectsByShape(shape);

    // Obtém os efeitos de animação do marcador de posição no slide de layout.
    IShape layoutShape = shape.GetBasePlaceholder();
    IEffect[] layoutShapeEffects = slide.LayoutSlide.Timeline.MainSequence.GetEffectsByShape(layoutShape);

    // Obtém os efeitos de animação do marcador de posição no slide mestre.
    IShape masterShape = layoutShape.GetBasePlaceholder();
    IEffect[] masterShapeEffects = slide.LayoutSlide.MasterSlide.Timeline.MainSequence.GetEffectsByShape(masterShape);

    Console.WriteLine("Main sequence of shape effects:");
    PrintEffects(masterShapeEffects);
    PrintEffects(layoutShapeEffects);
    PrintEffects(shapeEffects);
}

static void PrintEffects(IEnumerable<IEffect> effects)
{
    foreach (IEffect effect in effects)
    {
        Console.WriteLine($"{effect.Type} {effect.Subtype}");
    }
}

Output:

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

Alterar propriedades de tempo do efeito de animação

Aspose.Slides para .NET permite alterar as propriedades de Timing (tempo) de um efeito de animação.

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

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

• O menu suspenso Start do Timing do PowerPoint corresponde à propriedade Effect.Timing.TriggerType.
• O Duration do Timing do PowerPoint corresponde à propriedade Effect.Timing.Duration. A duração de uma animação (em segundos) é o tempo total que a animação leva para completar um ciclo.
• O Delay do Timing do PowerPoint corresponde à propriedade Effect.Timing.TriggerDelayTime.
• O menu suspenso Repeat do Timing do PowerPoint corresponde a estas propriedades:
  • a propriedade Effect.Timing.RepeatCount que descreve o número de vezes que o efeito é repetido;
  • a flag Effect.Timing.RepeatUntilEndSlide que especifica se o efeito é repetido até o final do slide;
  • a flag Effect.Timing.RepeatUntilNextClick que especifica se o efeito é repetido até o próximo clique.
• A caixa de seleção Rewind when done playing do Timing do PowerPoint corresponde à propriedade Effect.Timing.Rewind.

É assim que você altera as propriedades de Timing do Effect:

1. Aplicar ou obter o efeito de animação.
2. Defina novos valores para as propriedades Effect.Timing que você precisar.
3. Salve o arquivo PPTX modificado.

// Instancia uma classe de apresentação que representa um arquivo de apresentação.
using (Presentation pres = new Presentation("AnimExample_out.pptx"))
{
    // Obtém a sequência principal do slide.
    ISequence sequence = pres.Slides[0].Timeline.MainSequence;

    // Obtém o primeiro efeito da sequência principal.
    IEffect effect = sequence[0];

    // Altera o TriggerType do efeito para iniciar ao clicar
    effect.Timing.TriggerType = EffectTriggerType.OnClick;

    // Altera a duração do efeito
    effect.Timing.Duration = 3f;

    // Altera o TriggerDelayTime do efeito
    effect.Timing.TriggerDelayTime = 0.5f;

    // Se o valor de Repeat do efeito for "none"
    if (effect.Timing.RepeatCount == 1f)
    {
        // Altera o Repeat do efeito para "Until Next Click"
        effect.Timing.RepeatUntilNextClick = true;
    }
    else
    {
        // Altera o Repeat do efeito para "Until End of Slide"
        effect.Timing.RepeatUntilEndSlide = true;
    }

    // Ativa o Rewind do efeito
        effect.Timing.Rewind = true;
    
    // Salva o arquivo PPTX no disco
    pres.Save("AnimExample_changed.pptx", SaveFormat.Pptx);
}

Som do efeito de animação

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

• IEffect.Sound
• IEffect.StopPreviousSound

Adicionar som a um efeito de animação

using (Presentation pres = new Presentation("AnimExample_out.pptx"))
{
	// Adiciona áudio à coleção de áudio da apresentação
	IAudio effectSound = pres.Audios.AddAudio(File.ReadAllBytes("sampleaudio.wav"));

	ISlide firstSlide = pres.Slides[0];

	// Obtém a sequência principal do slide.
	ISequence sequence = firstSlide.Timeline.MainSequence;

	// Obtém o primeiro efeito da sequência principal
	IEffect firstEffect = sequence[0];

	// Verifica se o efeito está sem som
	if (!firstEffect.StopPreviousSound && firstEffect.Sound == null)
	{
		// Adiciona som ao primeiro efeito
		firstEffect.Sound = effectSound;
	}

	// Obtém a primeira sequência interativa do slide.
	ISequence interactiveSequence = firstSlide.Timeline.InteractiveSequences[0];

	// Define a flag de "Stop previous sound" do efeito
	interactiveSequence[0].StopPreviousSound = true;

	// Grava o arquivo PPTX no disco
	pres.Save("AnimExample_Sound_out.pptx", SaveFormat.Pptx);
}

Extrair som de um efeito de animação

1. Crie uma instância da classe Presentation.
2. Obtenha uma referência ao slide através de seu índice.
3. Obtenha a sequência principal de efeitos.
4. Extraia o Sound incorporado a cada efeito de animação.

// Instancia uma classe de apresentação que representa um arquivo de apresentação.
using (Presentation presentation = new Presentation("EffectSound.pptx"))
{
    ISlide slide = presentation.Slides[0];

    // Obtém a sequência principal do slide.
    ISequence sequence = slide.Timeline.MainSequence;

    foreach (IEffect effect in sequence)
    {
        if (effect.Sound == null)
            continue;

        // Extrai o som do efeito em array de bytes
        byte[] audio = effect.Sound.BinaryData;
    }
}

Depois da animação

Aspose.Slides para .NET permite alterar a propriedade After Animation (Depois da animação) de um efeito de animação.

Este é o painel de After Animation e o menu estendido no Microsoft PowerPoint:

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

• A propriedade IEffect.AfterAnimationType que descreve o tipo de 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).
  • 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.
• A propriedade IEffect.AfterAnimationColor que define o formato de cor After Animation. Esta propriedade funciona em conjunto com o tipo AfterAnimationType.Color. Se você mudar o tipo para outro, a cor After Animation será limpa.

// Instancia uma classe Presentation que representa um arquivo de apresentação
using (Presentation pres = new Presentation("AnimImage_out.pptx"))
{
    ISlide firstSlide = pres.Slides[0];

    // Obtém o primeiro efeito da sequência principal
    IEffect firstEffect = firstSlide.Timeline.MainSequence[0];

    // Altera o tipo de after animation para Cor
    firstEffect.AfterAnimationType = AfterAnimationType.Color;

    // Define a cor de escurecimento after animation
    firstEffect.AfterAnimationColor.Color = Color.AliceBlue;

    // Grava o arquivo PPTX no disco
    pres.Save("AnimImage_AfterAnimation.pptx", SaveFormat.Pptx);
}

Animar texto

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

• IEffect.AnimateTextType 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)
• IEffect.DelayBetweenTextParts 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 de Animate Text do Effect:

1. Aplicar ou obter o efeito de animação.
2. Defina a propriedade IEffect.TextAnimation.BuildType para o valor BuildType.AsOneObject para desativar o modo de animação By Paragraphs.
3. Defina novos valores para as propriedades IEffect.AnimateTextType e IEffect.DelayBetweenTextParts.
4. Salve o arquivo PPTX modificado.

// Instancia uma classe de apresentação que representa um arquivo de apresentação.
using (Presentation pres = new Presentation("AnimTextBox_out.pptx"))
{
    ISlide firstSlide = pres.Slides[0];

    // Obtém o primeiro efeito da sequência principal
    IEffect firstEffect = firstSlide.Timeline.MainSequence[0];

    // Altera o tipo de animação de texto do efeito para "As One Object"
    firstEffect.TextAnimation.BuildType = BuildType.AsOneObject;

    // Altera o tipo de animação de texto do efeito para "By word"
    firstEffect.AnimateTextType = AnimateTextType.ByWord;

    // Define o atraso entre palavras para 20% da duração do efeito
    firstEffect.DelayBetweenTextParts = 20f;

    // Grava o arquivo PPTX no disco
    pres.Save("AnimTextBox_AnimateText.pptx", SaveFormat.Pptx);
}

Perguntas frequentes

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

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

Como a mudança da ordem z (ordem de camadas) das formas afeta a animação?

Animação e ordem de desenho são independentes: um efeito controla o tempo e o tipo de aparecimento/desaparecimento, enquanto o z-order determina o que cobre o quê. O resultado visível é definido pela combinação de ambos. (Este é 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.