使用 Java 在演示文稿中应用形状动画

动画是可以应用于文本、图像、形状或图表的视觉效果。它们为演示文稿或其组成部分赋予活力。

为什么在演示文稿中使用动画？

使用动画，您可以

控制信息的流动
强调重要要点
提高观众的兴趣或参与度
使内容更易于阅读、理解或处理
吸引读者或观众注意演示文稿中的重要部分

PowerPoint 在进入、退出、强调和运动路径类别中提供了许多动画和动画效果的选项和工具。

Aspose.Slides 中的动画

Aspose.Slides 在 Aspose.Slides.Animation 命名空间下提供了处理动画所需的类和类型，
Aspose.Slides 在EffectType枚举中提供了超过150 个动画效果。这些效果本质上与 PowerPoint 中使用的效果相同（或等价）。

将动画应用于文本框

Aspose.Slides for Java 允许您为形状中的文本应用动画。

创建一个Presentation类的实例。
通过索引获取幻灯片的引用。
添加一个rectangleIAutoShape。
向IAutoShape.TextFrame添加文本。
获取主效果序列。
向IAutoShape添加动画效果。
将TextAnimation.BuildType属性设置为BuildType枚举中的值。
将演示文稿写入磁盘为 PPTX 文件。

此 Java 代码演示了如何将 Fade 效果应用于 AutoShape 并将文本动画设置为By 1st Level Paragraphs值：

// 实例化一个表示演示文稿文件的 Presentation 类。
Presentation pres = new Presentation();
try {
    ISlide sld = pres.getSlides().get_Item(0);

    // 添加带文本的新 AutoShape
    IAutoShape autoShape = sld.getShapes().addAutoShape(ShapeType.Rectangle, 20, 20, 150, 100);

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

    // 获取幻灯片的主序列。
    ISequence sequence = sld.getTimeline().getMainSequence();

    // 为形状添加 Fade 动画效果
    IEffect effect = sequence.addEffect(autoShape, EffectType.Fade, EffectSubtype.None, EffectTriggerType.OnClick);

    // 按一级段落动画化形状文本
    effect.getTextAnimation().setBuildType(BuildType.ByLevelParagraphs1);

    // 将 PPTX 文件保存到磁盘
    pres.save(path + "AnimText_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

除了将动画应用于文本之外，您还可以将动画应用于单个Paragraph。请参阅Animated Text。

将动画应用于 PictureFrame

创建一个Presentation类的实例。
通过索引获取幻灯片的引用。
在幻灯片上添加或获取一个PictureFrame。
获取主效果序列。
向PictureFrame添加动画效果。
将演示文稿写入磁盘为 PPTX 文件。

此 Java 代码演示了如何将 Fly 效果应用于图片框：

// 实例化一个表示演示文稿文件的 Presentation 类。
Presentation pres = new Presentation();
try {
    // 加载要添加到演示文稿图像集合的图片
    IPPImage picture;
    IImage image = Images.fromFile("aspose-logo.jpg");
    try {
        picture = pres.getImages().addImage(image);
    } finally {
        if (image != null) image.dispose();
    }

    // 向幻灯片添加图片框
    IPictureFrame picFrame = pres.getSlides().get_Item(0).getShapes().addPictureFrame(ShapeType.Rectangle, 50, 50, 100, 100, picture);

    // 获取幻灯片的主序列。
    ISequence sequence = pres.getSlides().get_Item(0).getTimeline().getMainSequence();

    // 为图片框添加从左侧飞入的动画效果
    IEffect effect = sequence.addEffect(picFrame, EffectType.Fly, EffectSubtype.Left, EffectTriggerType.OnClick);

    // 将 PPTX 文件保存到磁盘
    pres.save(path + "AnimImage_out.pptx", SaveFormat.Pptx);
} catch(IOException e) {
} finally {
    if (pres != null) pres.dispose();
}

将动画应用于形状

创建一个Presentation类的实例。
通过索引获取幻灯片的引用。
添加一个rectangleIAutoShape。
添加一个BevelIAutoShape（当此对象被点击时，动画将播放）。
在 bevel 形状上创建效果序列。
创建自定义UserPath。
添加移动到UserPath的命令。
将演示文稿写入磁盘为 PPTX 文件。

此 Java 代码演示了如何将 PathFootball（路径足球）效果应用于形状：

// 实例化一个表示 PPTX 文件的 Presentation 类。
Presentation pres = new Presentation();
try {
    ISlide sld = pres.getSlides().get_Item(0);

    // 从头创建现有形状的 PathFootball 效果。
    IAutoShape ashp = sld.getShapes().addAutoShape(ShapeType.Rectangle, 150, 150, 250, 25);
    ashp.addTextFrame("Animated TextBox");

    // 添加 PathFootBall 动画效果
    pres.getSlides().get_Item(0).getTimeline().getMainSequence().addEffect(ashp, EffectType.PathFootball,
            EffectSubtype.None, EffectTriggerType.AfterPrevious);

    // 创建某种 “按钮”。
    IShape shapeTrigger = pres.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Bevel, 10, 10, 20, 20);

    // 为此按钮创建一个效果序列。
    ISequence seqInter = pres.getSlides().get_Item(0).getTimeline().getInteractiveSequences().add(shapeTrigger);

     // 创建自定义用户路径。我们的对象仅在按钮被点击后移动。
    IEffect fxUserPath = seqInter.addEffect(ashp, EffectType.PathUser, EffectSubtype.None, EffectTriggerType.OnClick);

     // 添加移动命令，因为创建的路径为空。
    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);

     // 将 PPTX 文件写入磁盘
    pres.save("AnimExample_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

获取应用于形状的动画效果

以下示例演示了如何使用来自ISequence接口的getEffectsByShape方法来获取应用于形状的所有动画效果。

示例 1：获取普通幻灯片上形状的动画效果

之前，您已了解如何向 PowerPoint 演示文稿中的形状添加动画效果。下面的示例代码演示了如何获取演示文稿 AnimExample_out.pptx 中第一张普通幻灯片上第一个形状的已应用效果。

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

    // 获取幻灯片的主动画序列。
    ISequence sequence = firstSlide.getTimeline().getMainSequence();

    // 获取第一张幻灯片上的第一个形状。
    IShape shape = firstSlide.getShapes().get_Item(0);

    // 获取应用于该形状的动画效果。
    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();
}

示例 2：获取所有动画效果，包括从占位符继承的效果

如果普通幻灯片上的形状具有位于版式幻灯片和/或母版幻灯片上的占位符，并且这些占位符已添加动画效果，则在幻灯片放映期间将播放该形状的所有效果，包括从占位符继承的效果。

假设我们有一个 PowerPoint 演示文稿文件 sample.pptx，其中唯一一张幻灯片仅包含一个页脚形状，文本为 “Made with Aspose.Slides”，并对该形状应用了Random Bars效果。

幻灯片形状动画效果

再假设在layout幻灯片上的页脚占位符已应用Split效果。

版式形状动画效果

最后，master幻灯片上的页脚占位符已应用Fly In效果。

母版形状动画效果

以下示例代码演示了如何使用来自IShape接口的getBasePlaceholder方法来访问形状占位符并获取应用于页脚形状的动画效果，包括从版式和母版幻灯片上的占位符继承的效果。

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

更改动画效果时间属性

Aspose.Slides for Java 允许您更改动画效果的 Timing（时间）属性。

这是 Microsoft PowerPoint 中的动画时间窗格：示例1_图像

以下是 PowerPoint Timing 与Effect.Timing属性之间的对应关系：

PowerPoint Timing Start 下拉列表对应Effect.Timing.TriggerType属性。
PowerPoint Timing Duration 对应Effect.Timing.Duration属性。动画的持续时间（秒）是动画完成一次循环所需的总时间。
PowerPoint Timing Delay 对应Effect.Timing.TriggerDelayTime属性。

以下是更改 Effect Timing（效果时间）属性的方法：

Apply 或获取动画效果。
为所需的Effect.Timing属性设置新值。
保存修改后的 PPTX 文件。

此 Java 代码演示了该操作：

// 实例化一个表示演示文稿文件的 Presentation 类。
Presentation pres = new Presentation("AnimExample_out.pptx");
try {
    // 获取幻灯片的主序列。
    ISequence sequence = pres.getSlides().get_Item(0).getTimeline().getMainSequence();

    // 获取主序列的第一个效果。
    IEffect effect = sequence.get_Item(0);

    // 将效果的 TriggerType 更改为点击开始
    effect.getTiming().setTriggerType(EffectTriggerType.OnClick);

    // 更改效果持续时间
    effect.getTiming().setDuration(3f);

    // 更改效果触发延迟时间
    effect.getTiming().setTriggerDelayTime(0.5f);

    // 将 PPTX 文件保存到磁盘
    pres.save("AnimExample_changed.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

动画效果声音

Aspose.Slides 提供以下属性，以便在动画效果中使用声音：

添加动画效果声音

此 Java 代码演示了如何添加动画效果声音并在下一个效果开始时停止它：

Presentation pres = new Presentation("AnimExample_out.pptx");
try {
    // 向演示文稿的音频集合添加音频
    IAudio effectSound = pres.getAudios().addAudio(Files.readAllBytes(Paths.get("sampleaudio.wav")));

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

    // 获取幻灯片的主序列。
    ISequence sequence = firstSlide.getTimeline().getMainSequence();

    // 获取主序列的第一个效果
    IEffect firstEffect = sequence.get_Item(0);

    // 检查该效果是否为“无声音”
    if (!firstEffect.getStopPreviousSound() && firstEffect.getSound() == null)
    {
        // 为第一个效果添加声音
        firstEffect.setSound(effectSound);
    }

    // 获取幻灯片的第一个交互序列。
    ISequence interactiveSequence = firstSlide.getTimeline().getInteractiveSequences().get_Item(0);

    // 设置效果的“停止先前声音”标志
    interactiveSequence.get_Item(0).setStopPreviousSound(true);

    // 将 PPTX 文件写入磁盘
    pres.save("AnimExample_Sound_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

提取动画效果声音

创建一个Presentation类的实例。
通过索引获取幻灯片的引用。
获取主效果序列。
提取嵌入到每个动画效果中的setSound(IAudio value)。

此 Java 代码演示了如何提取嵌入在动画效果中的声音：

// 实例化一个表示演示文稿文件的 Presentation 类。
Presentation presentation = new Presentation("EffectSound.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    // 获取幻灯片的主序列。
    ISequence sequence = slide.getTimeline().getMainSequence();

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

        // 将效果声音提取为字节数组
        byte[] audio = effect.getSound().getBinaryData();
    }
} finally {
    if (presentation != null) presentation.dispose();
}

动画后

Aspose.Slides for Java 允许您更改动画效果的 After animation（动画后）属性。

这是 Microsoft PowerPoint 中的动画效果窗格和扩展菜单：示例1_图像

PowerPoint 效果 After animation 下拉列表对应以下属性：

setAfterAnimationType(int value) 属性描述 After animation 类型：
- PowerPoint More Colors 对应AfterAnimationType.Color类型；
- PowerPoint Don’t Dim 列表项对应AfterAnimationType.DoNotDim类型（默认的动画后类型）；
- PowerPoint Hide After Animation 项对应AfterAnimationType.HideAfterAnimation类型；
- PowerPoint Hide on Next Mouse Click 项对应AfterAnimationType.HideOnNextMouseClick类型；
setAfterAnimationColor(IColorFormat value) 属性定义动画后的颜色格式。此属性与AfterAnimationType.Color类型配合使用。如果将类型更改为其他类型，动画后的颜色将被清除。

此 Java 代码演示了如何更改动画后的效果：

// 实例化一个表示演示文稿文件的 Presentation 类
Presentation pres = new Presentation("AnimImage_out.pptx");
try {
    ISlide firstSlide = pres.getSlides().get_Item(0);

    // 获取主序列的第一个效果
    IEffect firstEffect = firstSlide.getTimeline().getMainSequence().get_Item(0);

    // 将动画结束类型更改为颜色
    firstEffect.setAfterAnimationType(AfterAnimationType.Color);

    // 设置动画结束时的暗淡颜色
    firstEffect.getAfterAnimationColor().setColor(Color.BLUE);

    // 将 PPTX 文件写入磁盘
    pres.save("AnimImage_AfterAnimation.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

动画文本

Aspose.Slides 提供以下属性，以便使用动画效果的 Animate text 块：

setAnimateTextType(int value) 用于描述效果的动画文本类型。形状文本可以按以下方式动画化：
- 全部一次显示 (AnimateTextType.AllAtOnce 类型)
- 按词 (AnimateTextType.ByWord 类型)
- 按字母 (AnimateTextType.ByLetter 类型)
setDelayBetweenTextParts(float value) 设置动画文本部分（词或字母）之间的延迟。正值指定效果持续时间的百分比，负值指定以秒为单位的延迟。

以下是更改 Effect Animate text（效果动画文本）属性的方法：

Apply 或获取动画效果。
将setBuildType(int value)属性设置为BuildType.AsOneObject值，以关闭By Paragraphs动画模式。
为setAnimateTextType(int value)和setDelayBetweenTextParts(float value)属性设置新值。
保存修改后的 PPTX 文件。

此 Java 代码演示了该操作：

// 实例化一个表示演示文稿文件的 Presentation 类。
Presentation pres = new Presentation("AnimTextBox_out.pptx");
try {
    ISlide firstSlide = pres.getSlides().get_Item(0);

    // 获取主序列的第一个效果
    IEffect firstEffect = firstSlide.getTimeline().getMainSequence().get_Item(0);

    // 将效果的文本动画类型更改为 "As One Object"
    firstEffect.getTextAnimation().setBuildType(BuildType.AsOneObject);

    // 将效果的 Animate text 类型更改为 "By word"
    firstEffect.setAnimateTextType(AnimateTextType.ByWord);

    // 将单词之间的延迟设置为效果持续时间的 20%
    firstEffect.setDelayBetweenTextParts(20f);

    // 将 PPTX 文件写入磁盘
    pres.save("AnimTextBox_AnimateText.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

常见问题

如何确保在将演示文稿发布到 Web 时动画得以保留？

Export to HTML5 并启用负责shape和transition动画的options。普通 HTML 不播放幻灯片动画，而 HTML5 能实现。

更改形状的 z 顺序（层次顺序）会如何影响动画？

动画顺序和绘制顺序是独立的：效果控制出现/消失的时间和类型，而z-order决定哪个覆盖哪个。可见结果由两者的组合决定。（这是 PowerPoint 的通用行为，Aspose.Slides 的效果与形状模型遵循相同逻辑。）

将动画转换为视频时是否对某些效果有限制？

总体而言，animations are supported，但在少数情况下或特定效果可能会有不同的渲染。建议使用您使用的效果以及相应的库版本进行测试。

在 Java 中获取演示文稿中的形状有效属性在 Java 中创建演示文稿形状的缩略图