Aplicar animaciones de forma en presentaciones usando Java

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?

Al usar animaciones, puedes

controlar el flujo de información
destacar puntos importantes
aumentar el interés o la participación de tu audiencia
hacer que el contenido sea más fácil de leer, asimilar o procesar
llamar la atención de tus 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 rutas de movimiento.

Animaciones en Aspose.Slides

Aspose.Slides proporciona las clases y tipos que necesitas 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 cuadro de texto

Aspose.Slides para Java permite aplicar animación al texto de una forma.

Crea una instancia de la clase Presentation.
Obtén una referencia a una diapositiva mediante su índice.
Añade un rectangle IAutoShape.
Añade texto a IAutoShape.TextFrame.
Obtén la secuencia principal de efectos.
Añade un efecto de animación a IAutoShape.
Establece la propiedad TextAnimation.BuildType al valor de la enumeración BuildType.
Guarda la presentación en el disco como un archivo PPTX.

Este código Java muestra cómo aplicar el efecto Fade a AutoShape y establecer la animación del texto al valor By 1st Level Paragraphs:

// Instancia una clase de presentación que representa un archivo de presentación.
Presentation pres = new Presentation();
try {
    ISlide sld = pres.getSlides().get_Item(0);

    // Añade un nuevo AutoShape con texto
    IAutoShape autoShape = sld.getShapes().addAutoShape(ShapeType.Rectangle, 20, 20, 150, 100);

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

    // Obtiene la secuencia principal de la diapositiva.
    ISequence sequence = sld.getTimeline().getMainSequence();

    // Añade el efecto de animación Fade a la forma
    IEffect effect = sequence.addEffect(autoShape, EffectType.Fade, EffectSubtype.None, EffectTriggerType.OnClick);

    // Anima el texto de la forma por párrafos de primer nivel
    effect.getTextAnimation().setBuildType(BuildType.ByLevelParagraphs1);

    // Guarda el archivo PPTX en disco
    pres.save(path + "AnimText_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Además de aplicar animaciones al texto, también puedes aplicar animaciones a un solo Paragraph. Consulta Animated Text.

Aplicar animación a un PictureFrame

Crea una instancia de la clase Presentation.
Obtén una referencia a una diapositiva mediante su índice.
Añade o obtén un PictureFrame en la diapositiva.
Obtén la secuencia principal de efectos.
Añade un efecto de animación a PictureFrame.
Guarda la presentación en el disco como un archivo PPTX.

Este código Java 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.
Presentation pres = new Presentation();
try {
    // Cargar imagen para añadir a la colección de imágenes de la presentación
    IPPImage picture;
    IImage image = Images.fromFile("aspose-logo.jpg");
    try {
        picture = pres.getImages().addImage(image);
    } finally {
        if (image != null) image.dispose();
    }

    // Añade un marco de imagen a la diapositiva
    IPictureFrame picFrame = pres.getSlides().get_Item(0).getShapes().addPictureFrame(ShapeType.Rectangle, 50, 50, 100, 100, picture);

    // Obtiene la secuencia principal de la diapositiva.
    ISequence sequence = pres.getSlides().get_Item(0).getTimeline().getMainSequence();

    // Añade el efecto de animación Fly desde la izquierda al marco de imagen
    IEffect effect = sequence.addEffect(picFrame, EffectType.Fly, EffectSubtype.Left, EffectTriggerType.OnClick);

    // Guarda el archivo PPTX en disco
    pres.save(path + "AnimImage_out.pptx", SaveFormat.Pptx);
} catch(IOException e) {
} finally {
    if (pres != null) pres.dispose();
}

Aplicar animación a una forma

Crea una instancia de la clase Presentation.
Obtén una referencia a una diapositiva mediante su índice.
Añade un rectangle IAutoShape.
Añade un Bevel [IAutoShape] (cuando se hace clic en este objeto, se reproduce la animación).
Crea una secuencia de efectos en la forma Bevel.
Crea un UserPath personalizado.
Añade comandos para mover al UserPath.
Guarda la presentación en el disco como un archivo PPTX.

Este código Java muestra cómo aplicar el efecto PathFootball (ruta de fútbol) a una forma:

// Instancia una clase Presentation que representa un archivo PPTX.
Presentation pres = new Presentation();
try {
    ISlide sld = pres.getSlides().get_Item(0);

    // Crea el efecto PathFootball para la forma existente desde cero.
    IAutoShape ashp = sld.getShapes().addAutoShape(ShapeType.Rectangle, 150, 150, 250, 25);
    ashp.addTextFrame("Animated TextBox");

    // Añade el efecto de animación PathFootBall
    pres.getSlides().get_Item(0).getTimeline().getMainSequence().addEffect(ashp, EffectType.PathFootball,
            EffectSubtype.None, EffectTriggerType.AfterPrevious);

    // Crea una especie de "botón".
    IShape shapeTrigger = pres.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Bevel, 10, 10, 20, 20);

    // Crea una secuencia de efectos para este botón.
    ISequence seqInter = pres.getSlides().get_Item(0).getTimeline().getInteractiveSequences().add(shapeTrigger);

     // Crea una ruta de usuario personalizada. Nuestro objeto se moverá solo después de pulsar el botón.
    IEffect fxUserPath = seqInter.addEffect(ashp, EffectType.PathUser, EffectSubtype.None, EffectTriggerType.OnClick);

     // Añade comandos para mover ya que la ruta creada está vacía.
    IMotionEffect motionBvh = ((IMotionEffect)fxUserPath.getBehaviors().get_Item(0));

    Point2D.Float[] pts = new Point2D.Float[1];
    pts[0] = new Point2D.Float(0.076f, 0.59f);
    motionBvh.getPath().add(MotionCommandPathType.LineTo, pts, MotionPathPointsType.Auto, true);
    pts[0] = new Point2D.Float(-0.076f, -0.59f);
    motionBvh.getPath().add(MotionCommandPathType.LineTo, pts, MotionPathPointsType.Auto, false);
    motionBvh.getPath().add(MotionCommandPathType.End, null, MotionPathPointsType.Auto, false);

     // Escribe el archivo PPTX en disco
    pres.save("AnimExample_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Obtener los efectos de animación aplicados a una forma

Los siguientes ejemplos 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, aprendiste cómo añadir efectos de animación a formas en presentaciones de PowerPoint. El siguiente código de ejemplo muestra cómo obtener los efectos aplicados a la primera forma de la primera diapositiva normal en la presentación AnimExample_out.pptx.

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

    // Obtiene la secuencia principal de animación de la diapositiva.
    ISequence sequence = firstSlide.getTimeline().getMainSequence();

    // Obtiene la primera forma de la primera diapositiva.
    IShape shape = firstSlide.getShapes().get_Item(0);

    // Obtiene los efectos de animación aplicados a la 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();
}

Ejemplo 2: Obtener todos los efectos de animación, incluidos los heredados de 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.

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.

Efecto de animación de forma en diapositiva

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

Efecto de animación de forma en diapositiva de diseño

Y, por último, se ha aplicado el efecto Fly In al marcador de posición del pie de página en la diapositiva maestra.

Efecto de animación de forma en diapositiva maestra

El siguiente código de ejemplo 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.

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);
    }
}

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

Cambiar propiedades de temporización del efecto de animación

Aspose.Slides para Java 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 de 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.
El 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:

Aplicar o obtener el efecto de animación.
Establece nuevos valores para las propiedades Effect.Timing que necesites.
Guarda el archivo PPTX modificado.

Este código Java demuestra la operación:

// Instancia una clase de presentación que representa un archivo de presentación.
Presentation pres = new Presentation("AnimExample_out.pptx");
try {
    // Obtiene la secuencia principal de la diapositiva.
    ISequence sequence = pres.getSlides().get_Item(0).getTimeline().getMainSequence();

    // Obtiene el primer efecto de la secuencia principal.
    IEffect effect = sequence.get_Item(0);

    // Cambia el TriggerType del efecto para iniciar al hacer clic
    effect.getTiming().setTriggerType(EffectTriggerType.OnClick);

    // Cambia la duración del efecto
    effect.getTiming().setDuration(3f);

    // Cambia el TriggerDelayTime del efecto
    effect.getTiming().setTriggerDelayTime(0.5f);

    // Guarda el archivo PPTX en disco
    pres.save("AnimExample_changed.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Sonido del efecto de animación

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

Añadir sonido a un efecto de animación

Este código Java muestra cómo añadir un sonido a un efecto de animación y detenerlo cuando comienza el siguiente efecto:

Presentation pres = new Presentation("AnimExample_out.pptx");
try {
    // Añade audio a la colección de audio de la presentación
    IAudio effectSound = pres.getAudios().addAudio(Files.readAllBytes(Paths.get("sampleaudio.wav")));

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

    // Obtiene la secuencia principal de la diapositiva.
    ISequence sequence = firstSlide.getTimeline().getMainSequence();

    // Obtiene el primer efecto de la secuencia principal
    IEffect firstEffect = sequence.get_Item(0);

    // Comprueba si el efecto no tiene sonido
    if (!firstEffect.getStopPreviousSound() && firstEffect.getSound() == null)
    {
        // Añade sonido al primer efecto
        firstEffect.setSound(effectSound);
    }

    // Obtiene la primera secuencia interactiva de la diapositiva.
    ISequence interactiveSequence = firstSlide.getTimeline().getInteractiveSequences().get_Item(0);

    // Establece la bandera del efecto "Stop previous sound"
    interactiveSequence.get_Item(0).setStopPreviousSound(true);

    // Escribe el archivo PPTX en disco
    pres.save("AnimExample_Sound_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Extraer sonido de un efecto de animación

Crea una instancia de la clase Presentation.
Obtén una referencia a una diapositiva mediante su índice.
Obtén la secuencia principal de efectos.
Extrae el setSound(IAudio value) incrustado en cada efecto de animación.

Este código Java 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.
Presentation presentation = new Presentation("EffectSound.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    // Obtiene la secuencia principal de la diapositiva.
    ISequence sequence = slide.getTimeline().getMainSequence();

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

        // Extrae el sonido del efecto en un array de bytes
        byte[] audio = effect.getSound().getBinaryData();
    }
} finally {
    if (presentation != null) presentation.dispose();
}

Después de la animación

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

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

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

setAfterAnimationType(int value) propiedad que describe el tipo After animation:
- PowerPoint More Colors coincide con el tipo AfterAnimationType.Color;
- PowerPoint Don’t Dim coincide con el tipo AfterAnimationType.DoNotDim que es el tipo predeterminado;
- PowerPoint Hide After Animation coincide con el tipo AfterAnimationType.HideAfterAnimation;
- PowerPoint Hide on Next Mouse Click coincide con el tipo AfterAnimationType.HideOnNextMouseClick;
setAfterAnimationColor(IColorFormat value) propiedad que define un formato de color después de la animación. Esta propiedad funciona junto con el tipo AfterAnimationType.Color. Si cambias el tipo a otro, el color después de la animación se borrará.

Este código Java muestra cómo cambiar un efecto después de la animación:

// Instancia una clase de presentación que representa un archivo de presentación
Presentation pres = new Presentation("AnimImage_out.pptx");
try {
    ISlide firstSlide = pres.getSlides().get_Item(0);

    // Obtiene el primer efecto de la secuencia principal
    IEffect firstEffect = firstSlide.getTimeline().getMainSequence().get_Item(0);

    // Cambia el tipo de animación posterior a Color
    firstEffect.setAfterAnimationType(AfterAnimationType.Color);

    // Establece el color de atenuación de la animación posterior
    firstEffect.getAfterAnimationColor().setColor(Color.BLUE);

    // Guarda el archivo PPTX en disco
    pres.save("AnimImage_AfterAnimation.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Animar texto

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

setAnimateTextType(int value) 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)
setDelayBetweenTextParts(float value) 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í puedes cambiar las propiedades del efecto Animate text:

Aplicar o obtener el efecto de animación.
Establece la propiedad setBuildType(int value) al valor [BuildType.AsOneObject] para desactivar el modo de animación By Paragraphs.
Establece nuevos valores para las propiedades setAnimateTextType(int value) y setDelayBetweenTextParts(float value).
Guarda el archivo PPTX modificado.

Este código Java demuestra la operación:

// Instancia una clase de presentación que representa un archivo de presentación.
Presentation pres = new Presentation("AnimTextBox_out.pptx");
try {
    ISlide firstSlide = pres.getSlides().get_Item(0);

    // Obtiene el primer efecto de la secuencia principal
    IEffect firstEffect = firstSlide.getTimeline().getMainSequence().get_Item(0);

    // Cambia el tipo de animación de texto del efecto a "Como un solo objeto"
    firstEffect.getTextAnimation().setBuildType(BuildType.AsOneObject);

    // Cambia el tipo de animación de texto del efecto a "Por palabra"
    firstEffect.setAnimateTextType(AnimateTextType.ByWord);

    // Establece el retraso entre palabras al 20% de la duración del efecto
    firstEffect.setDelayBetweenTextParts(20f);

    // Guarda el archivo PPTX en disco
    pres.save("AnimTextBox_AnimateText.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Preguntas frecuentes

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

Exportar a HTML5 y habilita las opciones responsables de las animaciones de shape y transition. El HTML simple 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 la temporización 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 vídeo para ciertos efectos?

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

Obtener propiedades efectivas de la forma desde presentaciones en Java Crear miniaturas de formas de presentación en Java