Aplicar animaciones de forma en presentaciones con C++

Las animaciones son efectos visuales que pueden aplicarse a textos, imágenes, formas o gráficos. Dan vida a las presentaciones o a sus componentes.

¿Por qué usar animaciones en presentaciones?

Usando animaciones, puedes

• controlar el flujo de información
• enfatizar puntos importantes
• aumentar el interés o la participación de su audiencia
• hacer que el contenido sea más fácil de leer, asimilar o procesar
• atraer la atención de sus lectores o espectadores a partes importantes de una presentación

PowerPoint ofrece muchas opciones y herramientas para animaciones y efectos de animación en las categorías de entrada, salida, énfasis y trayectorias de movimiento.

Animaciones en Aspose.Slides

• Aspose.Slides proporciona las clases y tipos que necesita para trabajar con animaciones bajo el espacio de nombres Aspose.Slides.Animation.
• Aspose.Slides ofrece más de 150 efectos de animación bajo la enumeración EffectType. Estos efectos son esencialmente los mismos (o equivalentes) que se usan en PowerPoint.

Aplicar animación a un TextBox

Aspose.Slides para C++ le permite aplicar animación al texto en una forma.

1. Cree una instancia de la clase Presentation.
2. Obtenga una referencia a una diapositiva mediante su índice.
3. Añada una rectangle IAutoShape.
4. Añada texto a IAutoShape.TextFrame.
5. Obtenga la secuencia principal de efectos.
6. Añada un efecto de animación a IAutoShape.
7. Establezca la propiedad TextAnimation.BuildType al valor de la Enumeración BuildType.
8. Guarde la presentación en disco como archivo PPTX.

Este código C++ le muestra cómo aplicar el efecto Fade a AutoShape y establecer la animación de texto al valor Por párrafos de primer nivel:

// Instancia una clase de presentación que representa un archivo de presentación.
System::SharedPtr<Presentation> pres = System::MakeObject<Presentation>();

System::SharedPtr<ISlide> sld = pres->get_Slides()->idx_get(0);

// Agrega un nuevo AutoShape con texto
System::SharedPtr<IAutoShape> autoShape =
    sld->get_Shapes()->AddAutoShape(Aspose::Slides::ShapeType::Rectangle, 20.0f, 20.0f, 150.0f, 100.0f);

System::SharedPtr<ITextFrame> textFrame = autoShape->get_TextFrame();
textFrame->set_Text(u"First paragraph \nSecond paragraph \n Third paragraph");

// Obtiene la secuencia principal de la diapositiva.
System::SharedPtr<ISequence> sequence = sld->get_Timeline()->get_MainSequence();

// Agrega el efecto de animación Fade a la forma
System::SharedPtr<IEffect> effect = sequence->AddEffect(autoShape, Aspose::Slides::Animation::EffectType::Fade,
    Aspose::Slides::Animation::EffectSubtype::None, Aspose::Slides::Animation::EffectTriggerType::OnClick);

// Anima el texto de la forma por párrafos de primer nivel
effect->get_TextAnimation()->set_BuildType(Aspose::Slides::Animation::BuildType::ByLevelParagraphs1);

// Guarda el archivo PPTX en disco
pres->Save(path + u"AnimText_out.pptx", Aspose::Slides::Export::SaveFormat::Pptx);

Además de aplicar animaciones al texto, también puede aplicar animaciones a un solo Paragraph. Consulte Texto animado.

Aplicar animación a un PictureFrame

1. Cree una instancia de la clase Presentation.
2. Obtenga una referencia a una diapositiva mediante su índice.
3. Añada o obtenga un PictureFrame en la diapositiva.
4. Obtenga la secuencia principal de efectos.
5. Añada un efecto de animación al PictureFrame.
6. Guarde la presentación en disco como archivo PPTX.

Este código C++ le muestra cómo aplicar el efecto Fly a un marco de imagen:

// Instancia una clase de presentación que representa un archivo de presentación.
System::SharedPtr<Presentation> pres = System::MakeObject<Presentation>();

// Carga la imagen que se agregará a la colección de imágenes de la presentación
System::SharedPtr<IImage> img = Images::FromFile(u"aspose-logo.jpg");
System::SharedPtr<IPPImage> image = pres->get_Images()->AddImage(img);

// Agrega un marco de imagen a la diapositiva
System::SharedPtr<IPictureFrame> picFrame =
    pres->get_Slides()->idx_get(0)->get_Shapes()->AddPictureFrame(Aspose::Slides::ShapeType::Rectangle, 50.0f, 50.0f, 100.0f, 100.0f, image);

// Obtiene la secuencia principal de la diapositiva.
System::SharedPtr<ISequence> sequence = pres->get_Slides()->idx_get(0)->get_Timeline()->get_MainSequence();

// Agrega el efecto de animación Fly desde la izquierda al marco de imagen
System::SharedPtr<IEffect> effect = sequence->AddEffect(picFrame, Aspose::Slides::Animation::EffectType::Fly,
    Aspose::Slides::Animation::EffectSubtype::Left, Aspose::Slides::Animation::EffectTriggerType::OnClick);

// Guarda el archivo PPTX en disco
pres->Save(path + u"AnimImage_out.pptx", Aspose::Slides::Export::SaveFormat::Pptx);

Aplicar animación a una Shape

1. Cree una instancia de la clase Presentation.
2. Obtenga una referencia a una diapositiva mediante su índice.
3. Añada una rectangle IAutoShape.
4. Añada una Bevel IAutoShape (cuando se haga clic en este objeto, se reproducirá la animación).
5. Cree una secuencia de efectos en la forma de bisel.
6. Cree un UserPath personalizado.
7. Añada comandos para mover al UserPath.
8. Guarde la presentación en disco como archivo PPTX.

Este código C++ le muestra cómo aplicar el efecto PathFootball (ruta futbol) a una forma:

	// La ruta al directorio del documento.
	const String outPath = u"../out/AnimationsOnShapes_out.pptx";
	const String templatePath = u"../templates/ConnectorLineAngle.pptx";

	// Carga la presentación
	SharedPtr<Presentation> pres = MakeObject<Presentation>();

	// Accede a la primera diapositiva
	SharedPtr<ISlide> slide = pres->get_Slides()->idx_get(0);

	// Accede a la colección de formas de la diapositiva seleccionada
	SharedPtr<IShapeCollection> shapes = slide->get_Shapes();

	// Crea el efecto PathFootball para la forma existente desde cero.
	SharedPtr<IAutoShape> ashp = slide->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 150, 150, 250, 25);

	ashp->AddTextFrame(u"Animated TextBox");

	// Añade el efecto de animación PathFootball
	slide->get_Timeline()->get_MainSequence()->AddEffect(ashp, EffectType::PathFootball,
		EffectSubtype::None, EffectTriggerType::AfterPrevious);

	// Crea algún tipo de "botón".
	SharedPtr<IAutoShape> shapeTrigger = slide->get_Shapes()->AddAutoShape(ShapeType::Bevel, 10, 10, 20, 20);

	// Crea una secuencia de efectos para este botón.
	SharedPtr<ISequence> seqInter = slide->get_Timeline()->get_InteractiveSequences()->Add(shapeTrigger);
	
	 // Crea una ruta de usuario personalizada. Nuestro objeto se moverá solo después de que se haga clic en el botón.
	SharedPtr<IEffect> fxUserPath = seqInter->AddEffect(ashp, EffectType::PathUser, EffectSubtype::None, EffectTriggerType::OnClick);

	// Añade comandos de movimiento ya que la ruta creada está vacía.
	 SharedPtr<MotionEffect> motionBhv = ExplicitCast<MotionEffect>(fxUserPath->get_Behaviors()->idx_get(0));

	// SharedPtr<PointF> point = MakeObject<PointF >(0.076, 0.59);
	 const PointF point = PointF (0.076, 0.59);
	 System::ArrayPtr<PointF> pts = System::MakeObject<System::Array<PointF>>(1, point);
	 motionBhv->get_Path()->Add(MotionCommandPathType::LineTo, pts, MotionPathPointsType::Auto, true);
	 
	 //PointF point2[1] = { -0.076, -0.59 };
	const  PointF point2 = PointF(-0.076, -0.59 );

	 System::ArrayPtr<PointF> pts2 = System::MakeObject<System::Array<PointF>>(1, point2);
	 motionBhv->get_Path()->Add(MotionCommandPathType::LineTo, pts2, MotionPathPointsType::Auto, false);
	 
	 motionBhv->get_Path()->Add(MotionCommandPathType::End, nullptr, MotionPathPointsType::Auto, false);
	 
	 // Escribe el archivo PPTX en disco
	 pres->Save(outPath, Aspose::Slides::Export::SaveFormat::Pptx);

Obtener los efectos de animación aplicados a una Shape

Los siguientes ejemplos le muestran cómo usar el método GetEffectsByShape de la interfaz ISequence para obtener todos los efectos de animación aplicados a una forma.

Ejemplo 1: Obtener efectos de animación aplicados a una forma en una diapositiva normal

Anteriormente, aprendió cómo añadir efectos de animación a formas en presentaciones de PowerPoint. El siguiente código de ejemplo le muestra cómo obtener los efectos aplicados a la primera forma de la primera diapositiva normal en la presentación AnimExample_out.pptx.

SharedPtr<Presentation> presentation = MakeObject<Presentation>(u"AnimExample_out.pptx");

SharedPtr<ISlide> firstSlide = presentation->get_Slide(0);

// Gets the main animation sequence of the slide.
SharedPtr<ISequence> sequence = firstSlide->get_Timeline()->get_MainSequence();

// Gets the first shape on the first slide.
SharedPtr<IShape> shape = firstSlide->get_Shape(0);

// Gets animation effects applied to the shape.
ArrayPtr<SharedPtr<IEffect>> shapeEffects = sequence->GetEffectsByShape(shape);

if (shapeEffects->get_Length() > 0)
{
    Console::WriteLine(u"The shape " + shape->get_Name() + u" has " + shapeEffects->get_Length() + u" animation effects.");
}

presentation->Dispose();

Ejemplo 2: Obtener todos los efectos de animación, incluidos los heredados de los marcadores de posición

Si una forma en una diapositiva normal tiene marcadores de posición que están en la diapositiva de diseño y/o en la diapositiva maestra, y se han añadido efectos de animación a esos marcadores de posición, entonces todos los efectos de la forma se reproducirán durante la presentación, incluidos los heredados de los marcadores de posición.

Supongamos que tenemos un archivo de presentación PowerPoint sample.pptx con una diapositiva que contiene solo una forma de pie de página con el texto “Made with Aspose.Slides” y al que se le ha aplicado el efecto Random Bars.

Supongamos también que el efecto Split se aplica al marcador de posición del pie de página en la diapositiva de diseño.

Y finalmente, el efecto Fly In se aplica al marcador de posición del pie de página en la diapositiva maestra.

El siguiente código de ejemplo le muestra cómo usar el método GetBasePlaceholder de la interfaz IShape para acceder a los marcadores de posición de la forma y obtener los efectos de animación aplicados a la forma del pie de página, incluidos los heredados de los marcadores de posición ubicados en las diapositivas de diseño y maestra.

void PrintEffects(ArrayPtr<SharedPtr<IEffect>> effects)
{
    for (SharedPtr<IEffect> effect : effects)
    {
        Console::WriteLine(String::Format(u"Type: {0}, subtype: {1}", effect->get_Type(), effect->get_Subtype()));
    }
}

SharedPtr<Presentation> presentation = MakeObject<Presentation>(u"sample.pptx");

SharedPtr<ISlide> slide = presentation->get_Slide(0);

// Obtiene los efectos de animación de la forma en la diapositiva normal.
SharedPtr<IShape> shape = slide->get_Shape(0);
ArrayPtr<SharedPtr<IEffect>> shapeEffects = slide->get_Timeline()->get_MainSequence()->GetEffectsByShape(shape);

// Obtiene los efectos de animación del marcador de posición en la diapositiva de diseño.
SharedPtr<IShape> layoutShape = shape->GetBasePlaceholder();
ArrayPtr<SharedPtr<IEffect>> layoutShapeEffects = slide->get_LayoutSlide()->get_Timeline()->get_MainSequence()->GetEffectsByShape(layoutShape);

// Obtiene los efectos de animación del marcador de posición en la diapositiva maestra.
SharedPtr<IShape> masterShape = layoutShape->GetBasePlaceholder();
ArrayPtr<SharedPtr<IEffect>> masterShapeEffects = slide->get_LayoutSlide()->get_MasterSlide()->get_Timeline()->get_MainSequence()->GetEffectsByShape(masterShape);

presentation->Dispose();

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

Salida:

Main sequence of shape effects:
Type: 47, subtype: 2              // Fly, Abajo
Type: 134, subtype: 45            // Split, EntradaVertical
Type: 126, subtype: 22            // RandomBars, Horizontal

Cambiar propiedades de tiempo del efecto de animación

Aspose.Slides para C++ le permite cambiar las propiedades de temporización de un efecto de animación.

Este es el panel de temporización de animación en Microsoft PowerPoint:

Estas son las correspondencias entre la temporización de PowerPoint y las propiedades Effect.Timing :

• La lista desplegable Start de la temporización de PowerPoint coincide con la propiedad Effect.Timing.TriggerType.
• La Duration de la temporización de PowerPoint coincide con la propiedad Effect.Timing.Duration. La duración de una animación (en segundos) es el tiempo total que tarda la animación en completar un ciclo.
• La Delay de la temporización de PowerPoint coincide con la propiedad Effect.Timing.TriggerDelayTime.

Así es como se cambian las propiedades de temporización del efecto:

1. Aplicar o obtener el efecto de animación.
2. Establezca nuevos valores para las propiedades Effect.Timing que necesite.
3. Guarde el archivo PPTX modificado.

Este código C++ demuestra la operación:

// Instancia una clase de presentación que representa un archivo de presentación.
System::SharedPtr<Presentation> pres = System::MakeObject<Presentation>(u"AnimExample_out.pptx");

// Obtiene la secuencia principal de la diapositiva.
System::SharedPtr<ISequence> sequence = pres->get_Slides()->idx_get(0)->get_Timeline()->get_MainSequence();

// Obtiene el primer efecto de la secuencia principal.
System::SharedPtr<IEffect> effect = sequence->idx_get(0);

// Cambia el tipo de activación del efecto para iniciar al hacer clic
effect->get_Timing()->set_TriggerType(Aspose::Slides::Animation::EffectTriggerType::OnClick);

// Cambia la duración del efecto
effect->get_Timing()->set_Duration(3.f);

// Cambia el tiempo de retraso del efecto
effect->get_Timing()->set_TriggerDelayTime(0.5f);

// Guarda el archivo PPTX en disco
pres->Save(u"AnimExample_changed.pptx", Aspose::Slides::Export::SaveFormat::Pptx);

Sonido del efecto de animación

Aspose.Slides proporciona estas propiedades para permitirle trabajar con sonidos en efectos de animación:

• set_Sound()
• set_StopPreviousSound()

Agregar un sonido al efecto de animación

Este código C++ le muestra cómo agregar un sonido a un efecto de animación y detenerlo cuando comienza el siguiente efecto:

System::SharedPtr<Presentation> pres = System::MakeObject<Presentation>(u"AnimExample_out.pptx");

// Añade audio a la colección de audio de la presentación
System::SharedPtr<IAudio> effectSound = pres->get_Audios()->AddAudio(System::IO::File::ReadAllBytes(u"sampleaudio.wav"));
System::SharedPtr<ISlide> firstSlide = pres->get_Slide(0);

// Obtiene la secuencia principal de la diapositiva.
System::SharedPtr<ISequence> sequence = firstSlide->get_Timeline()->get_MainSequence();

// Obtiene el primer efecto de la secuencia principal
System::SharedPtr<IEffect> firstEffect = sequence->idx_get(0);

// Verifica el efecto para "Sin sonido"
if (!firstEffect->get_StopPreviousSound() && firstEffect->get_Sound() == nullptr)
{
    // Añade sonido al primer efecto
    firstEffect->set_Sound(effectSound);
}

// Obtiene la primera secuencia interactiva de la diapositiva.
System::SharedPtr<ISequence> interactiveSequence = firstSlide->get_Timeline()->get_InteractiveSequence(0);

// Establece la bandera "Detener sonido anterior" del efecto
interactiveSequence->idx_get(0)->set_StopPreviousSound(true);

// Escribe el archivo PPTX en disco
pres->Save(u"AnimExample_Sound_out.pptx", SaveFormat::Pptx);

Extraer un sonido del efecto de animación

1. Cree una instancia de la clase Presentation.
2. Obtenga una referencia a una diapositiva mediante su índice.
3. Obtenga la secuencia principal de efectos.
4. Extraiga el sonido incrustado mediante set_Sound() de cada efecto de animación.

Este código C++ le muestra cómo extraer el sonido incrustado en un efecto de animación:

// Instancia una clase de presentación que representa un archivo de presentación.
System::SharedPtr<Presentation> pres = System::MakeObject<Presentation>(u"EffectSound.pptx");
System::SharedPtr<ISlide> slide = pres->get_Slide(0);

// Gets the main sequence of the slide.
System::SharedPtr<ISequence> sequence = slide->get_Timeline()->get_MainSequence();

for (auto&& effect : sequence)
{
    System::SharedPtr<IAudio> sound = effect->get_Sound();

    if (sound == nullptr)
        continue;

    auto audio = sound->get_BinaryData();
}

Después de la animación

Aspose.Slides para C++ le permite cambiar la propiedad After animation de un efecto de animación.

Este es el panel de efecto de animación y el menú extendido en Microsoft PowerPoint:

La lista desplegable After animation del efecto de PowerPoint coincide con estas propiedades:

• La propiedad set_AfterAnimationType() que describe el tipo de After animation :
  • PowerPoint More Colors coincide con el tipo AfterAnimationType.Color ;
  • PowerPoint Don’t Dim coincide con el tipo AfterAnimationType.DoNotDim (tipo predeterminado de after animation);
  • PowerPoint Hide After Animation coincide con el tipo AfterAnimationType.HideAfterAnimation ;
  • PowerPoint Hide on Next Mouse Click coincide con el tipo AfterAnimationType.HideOnNextMouseClick ;
• La propiedad set_AfterAnimationColor() que define un formato de color después de la animación. Esta propiedad funciona junto con el tipo AfterAnimationType.Color. Si cambia el tipo a otro, el color after animation se borrará.

Este código C++ le muestra cómo cambiar un efecto after animation:

// Instancia una clase de presentación que representa un archivo de presentación
System::SharedPtr<Presentation> pres = System::MakeObject<Presentation>(u"AnimImage_out.pptx");
System::SharedPtr<ISlide> firstSlide = pres->get_Slide(0);

// Obtiene el primer efecto de la secuencia principal
System::SharedPtr<IEffect> firstEffect = firstSlide->get_Timeline()->get_MainSequence()->idx_get(0);

// Cambia el tipo de animación posterior a Color
firstEffect->set_AfterAnimationType(AfterAnimationType::Color);

// Establece el color de atenuación después de la animación
firstEffect->get_AfterAnimationColor()->set_Color(System::Drawing::Color::get_AliceBlue());

// Escribe el archivo PPTX en disco
pres->Save(u"AnimImage_AfterAnimation.pptx", SaveFormat::Pptx);

Animar texto

Aspose.Slides proporciona estas propiedades para permitirle trabajar con el bloque Animate text de un efecto de animación:

• La propiedad set_AnimateTextType() que describe el tipo de animación de texto del efecto. El texto de la forma puede animarse:
  • Todo a la vez (AnimateTextType.AllAtOnce tipo)
  • Por palabra (AnimateTextType.ByWord tipo)
  • Por letra (AnimateTextType.ByLetter tipo)
• La propiedad set_DelayBetweenTextParts() establece un retraso entre las partes del texto animado (palabras o letras). Un valor positivo especifica el porcentaje de la duración del efecto. Un valor negativo especifica el retraso en segundos.

Así es como puede cambiar las propiedades Animate text del efecto:

1. Aplicar o obtener el efecto de animación.
2. Establezca la propiedad set_BuildType() al valor BuildType.AsOneObject para desactivar el modo de animación Por párrafos.
3. Establezca nuevos valores para las propiedades set_AnimateTextType y set_DelayBetweenTextParts.
4. Guarde el archivo PPTX modificado.

Este código C++ demuestra la operación:

// Instancia una clase de presentación que representa un archivo de presentación.
System::SharedPtr<Presentation> pres = System::MakeObject<Presentation>(u"AnimTextBox_out.pptx");
System::SharedPtr<ISlide> firstSlide = pres->get_Slide(0);

// Obtiene el primer efecto de la secuencia principal
System::SharedPtr<IEffect> firstEffect = firstSlide->get_Timeline()->get_MainSequence()->idx_get(0);

// Cambia el tipo de animación de texto del efecto a "Como un solo objeto"
firstEffect->get_TextAnimation()->set_BuildType(BuildType::AsOneObject);

// Cambia el tipo de animación de texto del efecto a "Por palabra"
firstEffect->set_AnimateTextType(AnimateTextType::ByWord);

// Establece el retraso entre palabras al 20% de la duración del efecto
firstEffect->set_DelayBetweenTextParts(20.0f);

// Escribe el archivo PPTX en disco
pres->Save(u"AnimTextBox_AnimateText.pptx", SaveFormat::Pptx);

FAQ

¿Cómo puedo asegurar que las animaciones se conserven al publicar la presentación en la web?

Exportar a HTML5 y habilite las opciones responsables de las animaciones de shape y transition. El HTML sencillo no reproduce animaciones de diapositivas, mientras que HTML5 sí lo hace.

¿Cómo afecta cambiar el orden z (orden de capas) de las formas a la animación?

El orden de animación y el orden de dibujo son independientes: un efecto controla el temporizador y el tipo de aparición/desaparición, mientras que el z-order determina qué cubre a qué. El resultado visible se define por su combinación. (Este es el comportamiento general de PowerPoint; el modelo de efectos y formas de Aspose.Slides sigue la misma lógica.)

¿Existen limitaciones al convertir animaciones a video para ciertos efectos?

En general, las animaciones son compatibles, pero en casos raros o con efectos específicos pueden renderizarse de manera diferente. Se recomienda probar con los efectos que use y con la versión de la biblioteca.