使用 Java 在簡報中套用形狀動畫

介紹

動畫是可以套用於文字、圖片、圖形或圖表的視覺效果。它們為簡報或其組件注入生命。

為什麼在簡報中使用動畫？

使用動畫，您可以

• 控制資訊流向
• 強調重要重點
• 增加觀眾的興趣或參與度
• 讓內容更容易閱讀、吸收或處理
• 吸引讀者或觀眾注意簡報中的重要部份

PowerPoint 在 入口、退出、強調 與 路徑動畫 四大類別中提供多種動畫與動畫效果選項與工具。

Aspose.Slides 中的動畫

• Aspose.Slides 在 Aspose.Slides.Animation 命名空間下提供您處理動畫所需的類別與型別，
• Aspose.Slides 於 EffectType 列舉中提供超過 150 種動畫效果。這些效果本質上與 PowerPoint 中使用的效果相同（或等價）。

將動畫套用至文字方塊

Aspose.Slides for Java 允許您對圖形中的文字套用動畫。

1. 建立 Presentation 類別的執行個體。
2. 透過索引取得投影片參考。
3. 新增 rectangle IAutoShape。
4. 新增文字至 IAutoShape.TextFrame。
5. 取得主要效果序列。
6. 為 IAutoShape 新增動畫效果。
7. 將 TextAnimation.BuildType 屬性設定為 BuildType 列舉中的值。
8. 將簡報寫入磁碟為 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

1. 建立 Presentation 類別的執行個體。
2. 透過索引取得投影片參考。
3. 在投影片上新增或取得 PictureFrame。
4. 取得主要效果序列。
5. 為 PictureFrame 新增動畫效果。
6. 將簡報寫入磁碟為 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();
}

將動畫套用至 Shape

1. 建立 Presentation 類別的執行個體。
2. 透過索引取得投影片參考。
3. 新增 rectangle IAutoShape。
4. 新增一個 Bevel IAutoShape（當此物件被點擊時，即會播放動畫）。
5. 為斜角形建立效果序列。
6. 建立自訂 UserPath。
7. 為 UserPath 新增移動指令。
8. 將簡報寫入磁碟為 PPTX 檔案。

以下 Java 程式碼示範如何將 PathFootball（路徑足球）效果套用至形狀：

// Instantiates a Presentation class that represents a PPTX file.
Presentation pres = new Presentation();
try {
    ISlide sld = pres.getSlides().get_Item(0);

    // Creates PathFootball effect for existing shape from scratch.
    IAutoShape ashp = sld.getShapes().addAutoShape(ShapeType.Rectangle, 150, 150, 250, 25);
    ashp.addTextFrame("Animated TextBox");

    // Adds the PathFootBall animation effect
    pres.getSlides().get_Item(0).getTimeline().getMainSequence().addEffect(ashp, EffectType.PathFootball,
            EffectSubtype.None, EffectTriggerType.AfterPrevious);

    // Creates some kind of "button".
    IShape shapeTrigger = pres.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Bevel, 10, 10, 20, 20);

    // Creates a sequence of effects for this button.
    ISequence seqInter = pres.getSlides().get_Item(0).getTimeline().getInteractiveSequences().add(shapeTrigger);

     // Creates a custom user path. Our object will be moved only after the button is clicked.
    IEffect fxUserPath = seqInter.addEffect(ashp, EffectType.PathUser, EffectSubtype.None, EffectTriggerType.OnClick);

     // Adds commands for moving since created path is empty.
    IMotionEffect motionBhv = ((IMotionEffect)fxUserPath.getBehaviors().get_Item(0));

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

     // Writes the PPTX file to disk
    pres.save("AnimExample_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

取得套用於 Shape 的動畫效果

以下範例說明如何使用 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 效果。

再假設在 版面 投影片的頁腳佔位符上已套用 Split 效果。

最後，在 母片 投影片的頁腳佔位符上套用 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 允許您變更動畫效果的時間屬性。

以下為 Microsoft PowerPoint 中的動畫時間面板：

PowerPoint 時間與 Effect.Timing 屬性之對應關係如下：

• PowerPoint 時間 Start 下拉清單對應 Effect.Timing.TriggerType 屬性。
• PowerPoint 時間 Duration 對應 Effect.Timing.Duration 屬性。動畫的持續時間（以秒為單位）為動畫完成一次循環所需的總時間。
• PowerPoint 時間 Delay 對應 Effect.Timing.TriggerDelayTime 屬性。

以下說明如何變更 Effect Timing 屬性：

1. 套用或取得動畫效果。
2. 為需要變更的 Effect.Timing 屬性設定新值。
3. 儲存修改後的 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);

    // 變更效果的 TriggerDelayTime
    effect.getTiming().setTriggerDelayTime(0.5f);

    // 將 PPTX 檔案儲存至磁碟
    pres.save("AnimExample_changed.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

動畫效果音效

Aspose.Slides 提供以下屬性，讓您在動畫效果中處理音效：

• setSound(IAudio value)
• setStopPreviousSound(boolean value)

新增動畫效果音效

以下 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);

    // 檢查效果是否為「No Sound」(無音效)
    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();
}

擷取動畫效果音效

1. 建立 Presentation 類別的執行個體。
2. 透過索引取得投影片參考。
3. 取得主要效果序列。
4. 擷取每個動畫效果所嵌入的 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 允許您變更動畫效果的「動畫結束後」屬性。

以下為 Microsoft PowerPoint 中的動畫效果面板與延伸功能表：

PowerPoint 的 After animation 下拉清單對應以下屬性：

• setAfterAnimationType(int value) 屬性描述動畫結束後的類型：
  • 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);

    // 將動畫結束後的類型變更為 Color
    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 屬性：

1. 套用或取得動畫效果。
2. 將 setBuildType(int value) 屬性設定為 BuildType.AsOneObject 以關閉 By Paragraphs 動畫模式。
3. 為 setAnimateTextType(int value) 與 setDelayBetweenTextParts(float value) 設定新值。
4. 儲存修改後的 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);

    // 將效果的動畫文字類型變更為「By word」
    firstEffect.setAnimateTextType(AnimateTextType.ByWord);

    // 設定字詞之間的延遲為效果持續時間的 20%
    firstEffect.setDelayBetweenTextParts(20f);

    // 將 PPTX 檔案寫入磁碟
    pres.save("AnimTextBox_AnimateText.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

常見問題

如何確保在將簡報發佈至網路時動畫不會遺失？

匯出為 HTML5 並啟用負責 shape 與 transition 動畫的 options。純 HTML 無法播放投影片動畫，而 HTML5 能夠播放。

變更形狀的 Z 順序（圖層順序）會如何影響動畫？

動畫與繪製順序相互獨立：效果控制出現/消失的時機與類型，而 z-order 決定哪個物件遮蓋哪個。最終呈現結果是兩者結合的結果。（這是 PowerPoint 的一般行為，Aspose.Slides 的效果與形狀模型亦遵循相同邏輯。）

將某些動畫轉換為影片時是否有限制？

一般而言，動畫受支援，但個別稀有情況或特定效果可能會有不同的呈現方式。建議以實際使用的效果與所使用的函式庫版本進行測試。