使用 Python via Java 管理簡報中的投影片過渡

概述

投影片過渡控制投影片在投影片放映期間的顯示方式。使用 Aspose.Slides for Python via Java,您可以為每張投影片選擇過渡效果、設定滑鼠點擊或計時器的前進方式,並調整特定效果的選項。本文使用 Python 範例套用過渡、設定精確的過渡持續時間、管理投影片計時,並在兩張投影片之間建立 Morph 過渡。範例還說明如何將設定儲存為 PPTX 檔案。

新增投影片過渡

要套用過渡,使用簡報類別載入簡報,並透過getSlideShowTransition存取投影片的過渡設定。使用setType,傳入TransitionType列舉中的值,然後儲存簡報。

以下範例將 Circle 過渡套用於第一張投影片,將 Comb 過渡套用於第二張。請使用至少包含兩張投影片的 input.pptx 檔案。

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat, TransitionType

presentation = Presentation("input.pptx")
try:
    if presentation.getSlides().size() >= 2:
        presentation.getSlides().get_Item(0).getSlideShowTransition().setType(TransitionType.Circle)
        presentation.getSlides().get_Item(1).getSlideShowTransition().setType(TransitionType.Comb)

        presentation.save("slide-transitions.pptx", SaveFormat.Pptx)
    else:
        print("The input presentation must contain at least two slides.")
finally:
    presentation.dispose()

輪形過渡

使用setType從TransitionType中選取 Wheel。然後呼叫getValue以存取WheelTransition設定。其setSpokes方法控制有多少輻射扇形會顯示目標投影片。

此範例建立兩組相同的投影片。每組以黑色投影片開始,並以全投影片的金色矩形結束。兩個目標投影片皆使用相同的慢速(透過setSpeed設定)以及相同的明確持續時間 8,000 毫秒(透過setDuration設定)。僅改變扇形的數量。

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import BackgroundType, FillType, Presentation, SaveFormat, ShapeType, TransitionSpeed, TransitionType

Color = jpype.JClass("java.awt.Color")
presentation = Presentation()
try:
    width = jpype.JFloat(presentation.getSlideSize().getSize().getWidth())
    height = jpype.JFloat(presentation.getSlideSize().getSize().getHeight())

    slides = presentation.getSlides()
    black_slide = slides.get_Item(0)
    black_slide.getShapes().clear()
    background = black_slide.getBackground()
    background.setType(BackgroundType.OwnBackground)
    background.getFillFormat().setFillType(FillType.Solid)
    background.getFillFormat().getSolidFillColor().setColor(Color.BLACK)

    destination_slide = slides.addClone(black_slide)
    rectangle = destination_slide.getShapes().addAutoShape(ShapeType.Rectangle, 0, 0, width, height)
    rectangle.getFillFormat().setFillType(FillType.Solid)
    rectangle.getFillFormat().getSolidFillColor().setColor(Color(255, 215, 0))
    rectangle.getTextFrame().setText("Wheel transition")

    slides.addClone(black_slide)
    slides.addClone(destination_slide)
    for slide_index, spokes in ((1, 1), (3, 8)):
        transition = slides.get_Item(slide_index).getSlideShowTransition()
        transition.setType(TransitionType.Wheel)
        wheel_transition = transition.getValue()
        wheel_transition.setSpokes(spokes)
        transition.setSpeed(TransitionSpeed.Slow)
        transition.setDuration(8000)

    presentation.save("wheel-transitions.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

在 PowerPoint 中開啟 wheel-transitions.pptx,然後開始投影片放映。從投影片 1 前進至投影片 2,即可看到一次順時針掃描揭示金色矩形。接著從投影片 3 前進至投影片 4,即可看到八個輻射扇形同時揭示相同的矩形。

新增進階投影片過渡

您可以設定投影片在畫面上停留的時間以及是否透過滑鼠點擊前進投影片放映。以下方法可控制此行為:

啟用點擊與計時雙重前進,讓觀眾可點擊前進或等待計時器。若僅使用計時器,請將 False 傳遞給setAdvanceOnClick。此延遲控制投影片放映何時前進;它不會設定視覺過渡效果的持續時間。

此範例將不同效果指派給前三張投影片,並分別在 3、5、7 秒後啟用自動前進。滑鼠點擊亦可前進這些投影片。請使用至少包含三張投影片的 input.pptx 檔案。

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat, TransitionType

presentation = Presentation("input.pptx")
try:
    if presentation.getSlides().size() >= 3:
        first_transition = presentation.getSlides().get_Item(0).getSlideShowTransition()
        first_transition.setType(TransitionType.Circle)
        first_transition.setAdvanceOnClick(True)
        first_transition.setAdvanceAfter(True)
        first_transition.setAdvanceAfterTime(3000)

        second_transition = presentation.getSlides().get_Item(1).getSlideShowTransition()
        second_transition.setType(TransitionType.Comb)
        second_transition.setAdvanceOnClick(True)
        second_transition.setAdvanceAfter(True)
        second_transition.setAdvanceAfterTime(5000)

        third_transition = presentation.getSlides().get_Item(2).getSlideShowTransition()
        third_transition.setType(TransitionType.Zoom)
        third_transition.setAdvanceOnClick(True)
        third_transition.setAdvanceAfter(True)
        third_transition.setAdvanceAfterTime(7000)

        presentation.save("advanced-transitions.pptx", SaveFormat.Pptx)
    else:
        print("The input presentation must contain at least three slides.")
finally:
    presentation.dispose()

若要檢查是否已啟用計時前進,請呼叫getAdvanceAfter。僅有儲存的延遲並不表示計時器已啟動。

下一個範例開啟上述已儲存的檔案,報告每個已啟用的計時器,並對延遲超過兩秒的投影片停用自動前進。對這些投影片啟用滑鼠點擊,並儲存更新後的設定。

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation("advanced-transitions.pptx")
try:
    for slide in presentation.getSlides():
        transition = slide.getSlideShowTransition()

        if transition.getAdvanceAfter():
            print(f"Slide {slide.getSlideNumber()}: advance after {transition.getAdvanceAfterTime()} ms.")

            if transition.getAdvanceAfterTime() > 2000:
                transition.setAdvanceAfter(False)
                transition.setAdvanceOnClick(True)

    presentation.save("adjusted-transitions.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

精確控制過渡時序

使用setDuration以毫秒為單位指定過渡效果的精確長度。投影片的getSlideShowTransition方法透過SlideShowTransition暴露這些設定:

方法 目的
setDuration 設定過渡效果本身的持續時間(以毫秒為單位)。
setAdvanceAfterTime 設定投影片自動前進前的延遲時間(以毫秒為單位)。傳遞 True 給setAdvanceAfter以啟用此計時器。
setSpeed 從TransitionSpeed選取預定義的速度類別:Slow、Medium 或 Fast。當未指定精確持續時間時使用此設定。

setDuration 只控制過渡效果;它不會決定投影片的可見時間。請另行設定自動前進的延遲。若未設定明確的持續時間,Aspose.Slides 會根據過渡類型與getSpeed的值來決定效果持續時間。

分別的條形指示 750 毫秒的過渡持續時間和 5,000 毫秒的自動前進設定.

共享範例為每張投影片設定 750 毫秒的淡出過渡,並分別在 5,000 毫秒後啟用自動前進。過渡持續時間控制效果;前進時間控制何時離開投影片。這些條形是示意設定,非實測的合併時間軸。

將相同持續時間套用於每張投影片

為了保持節奏一致,將相同的效果與精確持續時間套用於每張投影片。此範例載入 input.pptx,從TransitionType選擇 Fade,並將每個過渡的持續時間設定為 750 毫秒。它分別在 5,000 毫秒後啟用自動前進,且停用滑鼠點擊前進,最後將結果儲存為 PPTX。

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat, TransitionType

presentation = Presentation("input.pptx")
try:
    for slide in presentation.getSlides():
        transition = slide.getSlideShowTransition()
        transition.setType(TransitionType.Fade)
        transition.setDuration(750)

        # 配置自動前進,與效果持續時間無關。
        transition.setAdvanceAfter(True)
        transition.setAdvanceAfterTime(5000)
        transition.setAdvanceOnClick(False)

    presentation.save("precise-transitions.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

為個別投影片設定不同持續時間

不同的投影片可以使用不同的效果持續時間。例如,為標題投影片使用較短的過渡,為章節介紹使用較長的過渡。此範例將第一張投影片設定為 500 毫秒,第二張設定為 1,200 毫秒。請使用至少包含兩張投影片的 input.pptx 檔案。

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat, TransitionType

presentation = Presentation("input.pptx")
try:
    if presentation.getSlides().size() >= 2:
        first_transition = presentation.getSlides().get_Item(0).getSlideShowTransition()
        first_transition.setType(TransitionType.Fade)
        first_transition.setDuration(500)

        second_transition = presentation.getSlides().get_Item(1).getSlideShowTransition()
        second_transition.setType(TransitionType.Push)
        second_transition.setDuration(1200)

        presentation.save("individual-transition-durations.pptx", SaveFormat.Pptx)
    else:
        print("The input presentation must contain at least two slides.")
finally:
    presentation.dispose()

將過渡與動畫輸出協調

在準備動畫 GIF、HTML5 簡報、或影片時,請在匯出前設定精確的過渡持續時間,以符合預期節奏。例如,在場景之間使用 600 毫秒的淡出,並分別調整每張投影片的前進延遲,以留出旁白或內容的時間。

對於 GIF 與影片,請將輸出幀率與效果持續時間協調:600 毫秒相當於 30 幀每秒時的 18 幀。於 HTML5 中,於匯出設定中啟用動畫過渡。檢查所選匯出格式支援的效果與時序選項,並預覽輸出以確認同步。

讀取現有過渡持續時間

在修改過渡之前,先呼叫getDuration以判斷是否已儲存明確的值。-1 表示未設定明確的持續時間;非負值則指定以毫秒為單位的儲存持續時間。未設定的值並非計算出的播放持續時間:Aspose.Slides 會根據過渡類型與getSpeed的值來決定該持續時間。設定過渡類型可能會初始化持續時間,因此請先檢查原始設定。

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation

presentation = Presentation("input.pptx")
try:
    for slide in presentation.getSlides():
        transition = slide.getSlideShowTransition()
        duration = transition.getDuration()

        if duration >= 0:
            print(f"Slide {slide.getSlideNumber()}: stored transition duration is {duration} ms.")
        else:
            print(f"Slide {slide.getSlideNumber()}: no explicit duration; timing depends on transition type {transition.getType()} and speed {transition.getSpeed()}.")
finally:
    presentation.dispose()

Morph 過渡

Morph 過渡會在連續投影片之間動畫化物件的變化。要建立簡單的 Morph 效果,先複製投影片,於複製稿上移動或調整物件大小,然後將 Morph 過渡套用於第二張投影片。此方式讓過渡對應的物件在原始與修改後的狀態之間進行動畫。

以下範例建立一張含文字矩形的投影片,複製該投影片,並在複製稿上變更矩形的位置與大小。接著於第二張投影片從TransitionType列舉中選取 Morph。於支援 Morph 的簡報檢視器中開啟已儲存的檔案,即可在投影片放映時看到效果。

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat, TransitionType, ShapeType

presentation = Presentation()
try:
    first_slide = presentation.getSlides().get_Item(0)
    rectangle = first_slide.getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 400, 100)
    rectangle.getTextFrame().setText("Morph transition")

    second_slide = presentation.getSlides().addClone(first_slide)
    moved_rectangle = second_slide.getShapes().get_Item(0)
    moved_rectangle.setX(moved_rectangle.getX() + 100)
    moved_rectangle.setY(moved_rectangle.getY() + 50)
    moved_rectangle.setWidth(moved_rectangle.getWidth() - 200)
    moved_rectangle.setHeight(moved_rectangle.getHeight() - 10)

    second_slide.getSlideShowTransition().setType(TransitionType.Morph)

    presentation.save("morph-transition.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Morph 過渡類型

TransitionMorphType 列舉控制 Morph 如何匹配與動畫化內容:

  • ByObject 將每個形狀視為完整物件。
  • ByWord 盡可能以單字匹配方式動畫化文字。
  • ByChar 盡可能以字元匹配方式動畫化文字。

在存取getValue之前,使用setType選取 Morph。此時返回值為MorphTransition類別的實例,其setMorphType方法可選擇匹配模式。

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat, TransitionType, TransitionMorphType, MorphTransition

presentation = Presentation("morph-transition.pptx")
try:
    if presentation.getSlides().size() >= 2:
        transition = presentation.getSlides().get_Item(1).getSlideShowTransition()
        transition.setType(TransitionType.Morph)
        transition_value = transition.getValue()

        if isinstance(transition_value, MorphTransition):
            morph_transition = transition_value
            morph_transition.setMorphType(TransitionMorphType.ByWord)
            presentation.save("morph-by-word.pptx", SaveFormat.Pptx)
        else:
            print("Morph transition options are unavailable.")
    else:
        print("The input presentation must contain at least two slides.")
finally:
    presentation.dispose()

設定過渡效果

某些過渡具備額外選項,例如方向或是否從黑色畫面開始。可用的選項取決於使用setType所選的過渡。請先設定類型,然後從getValue取得相應的類別。

以下範例將 Cut 過渡套用於 input.pptx 的第一張投影片。它透過OptionalBlackTransition呼叫setFromBlack,使過渡從黑色畫面開始。

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat, TransitionType, OptionalBlackTransition

presentation = Presentation("input.pptx")
try:
    transition = presentation.getSlides().get_Item(0).getSlideShowTransition()
    transition.setType(TransitionType.Cut)
    transition_value = transition.getValue()

    if isinstance(transition_value, OptionalBlackTransition):
        cut_transition = transition_value
        cut_transition.setFromBlack(True)
        presentation.save("cut-from-black.pptx", SaveFormat.Pptx)
    else:
        print("Cut transition options are unavailable.")
finally:
    presentation.dispose()

常見問題

我可以控制投影片過渡的播放速度嗎?

是。當您需要以毫秒為單位的精確效果持續時間時,請使用setDuration。當預定義的TransitionSpeed類別(Slow、Medium 或 Fast)已足夠且未設定明確持續時間時,請使用setSpeed。這些設定會獨立於自動前進延遲,僅控制過渡效果。

我可以將音訊附加到過渡並使其循環播放嗎?

是。可使用setSound指定嵌入式音訊,將TransitionSoundMode列舉中的 StartSound 傳遞給setSoundMode,並以 True 啟用setSoundLoop。音訊會持續循環,直到投影片放映中的下一個音效事件為止。

將相同過渡套用於每張投影片的最快方法是什麼?

遍歷簡報的getSlides集合,對每張投影片的過渡呼叫setType並使用相同的值。於同一迴圈中設定任何時序與效果選項,以確保所有投影片的行為一致。

我如何檢查投影片上目前設定的過渡是什麼?

對投影片的getSlideShowTransition結果呼叫getType。它會返回TransitionType列舉中的值;None_ 表示未套用任何過渡效果。