Python via Java を使用してプレゼンテーションのスライドトランジションを管理する

このページの概要

Aspose.Slides for Python via Java を使用してスライドトランジションを適用し、自動スライド進行を設定し、Morph などのトランジション効果をカスタマイズします。

概要

スライドトランジションは、スライドショー中にスライドがどのように表示されるかを制御します。Aspose.Slides for Python via Java を使用すると、各スライドにトランジション効果を選択し、マウスクリックまたはタイマーによる進行を設定し、効果固有のオプションを調整できます。この記事では、Python のサンプルを用いてトランジションの適用、正確なトランジション時間の設定、スライドタイミングの管理、2 枚のスライド間の Morph トランジションの作成方法を示します。また、設定を PPTX ファイルに保存する方法も紹介します。

スライドトランジションの追加

トランジションを適用するには、Presentation クラスでプレゼンテーションを読み込み、getSlideShowTransition でスライドのトランジション設定にアクセスします。setType に TransitionType 列挙から値を指定し、プレゼンテーションを保存します。

次の例は、最初のスライドに Circle トランジション、2 番目のスライドに Comb トランジションを適用します。最低でも 2 枚のスライドがある 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()

高度なスライドトランジションの追加

スライドが画面に表示され続ける時間や、マウスクリックでスライドショーを進めるかどうかを構成できます。以下のメソッドでこの動作を制御します。

setAdvanceOnClick は、マウスクリックで進められるようにします。
setAdvanceAfter は、自動進行を有効にします。
setAdvanceAfterTime は、自動進行までの遅延時間（ミリ秒）を指定します。

クリックとタイマーの両方を有効にすれば、クリックでもタイマー待ちでも次へ進められます。タイマーのみ使用する場合は、setAdvanceOnClick に False を渡してください。遅延はスライドショーの進行時期を決めるだけで、視覚的なトランジション効果の長さを設定するものではありません。

この例では、最初の 3 枚のスライドに異なる効果を割り当て、3 秒、5 秒、7 秒後に自動進行するように設定します。マウスクリックでもこれらのスライドは進められます。最低でも 3 枚のスライドがある 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 を呼びます。遅延が保存されているだけでは、タイマーがアクティブかどうかは判断できません。

次の例は、上記で保存したファイルを開き、設定されたタイマーを各スライドで報告し、2 秒以上の遅延があるスライドの自動進行を無効にします。そのスライドはクリックで進められるようにし、設定を保存します。

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	スライドが自動的に進むまでの遅延時間（ミリ秒）を設定します。タイマーを有効にするには、setAdvanceAfter に `True` を渡します。
setSpeed	TransitionSpeed 列挙から Slow、Medium、Fast のいずれかを選択します。正確な期間が指定されていない場合に使用されます。

setDuration はトランジション効果のみを制御し、スライドが画面に残る時間は決定しません。自動進行の遅延は別途設定してください。明示的な期間が設定されていない場合、Aspose.Slides はトランジションの種類と getSpeed の値から効果の継続時間を算出します。

すべてのスライドに同一の期間を適用する

一定のリズムを保つには、すべてのスライドに同じ効果と正確な期間を適用します。この例は 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 ミリ秒、2 番目のスライドを 1,200 ミリ秒に設定します。最低でも 2 枚のスライドがある 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()

アニメーション出力とトランジションを連携させる

animated GIF、HTML5 プレゼンテーション、または動画を作成する際は、エクスポート前に正確なトランジション期間を設定して意図したリズムに合わせます。たとえば、シーン間に 600 ミリ秒のフェードを使用し、各スライドの進行遅延を個別に調整してナレーションやコンテンツの時間を確保します。

GIF や動画の場合、出力フレームレートと効果期間を合わせます。600 ミリ秒は 30 fps の場合 18 フレームに相当します。HTML5 ではエクスポート設定でアニメーショントランジションを有効にします。選択したフォーマットがサポートする効果とタイミングオプションを確認し、プレビューで同期を確認してください。

既存のトランジション期間を取得する

トランジションを変更する前に getDuration を呼び出して、明示的な値が保存されているか確認します。-1 は明示的な期間が設定されていないことを示し、0 以上の値はミリ秒単位の保存された期間です。未設定の値は再生時間の計算結果ではなく、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 効果を作成するには、スライドを複製し、複製したスライド上のオブジェクトを移動またはサイズ変更し、2 枚目のスライドに Morph トランジションを適用します。これにより、元の状態と変更後の状態の間で対応するオブジェクトがアニメーション化されます。

以下の例は、テキスト矩形を持つスライドを作成し、スライドを複製して矩形の位置とサイズを変更します。2 枚目のスライドの 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 は、可能な限り文字単位でテキストをアニメーション化します。

[Morph] を選択するには、setType を呼び、続いて getValue にアクセスします。取得した値は MorphTransition クラスのインスタンスであり、setMorphType メソッドでマッチングモードを選択します。

この例は前節で作成したプレゼンテーションを開き、2 枚目のスライドに単語ベースの Morph アニメーションを設定します。

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 から適切なクラスを使用します。

以下の例は input.pptx の最初のスライドに Cut トランジションを適用します。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()

FAQ

スライドトランジションの再生速度を制御できますか？

はい。ミリ秒単位で正確な効果時間が必要な場合は setDuration を使用してください。事前定義された TransitionSpeed（Slow、Medium、Fast）のカテゴリで十分で、明示的な期間を設定しない場合は setSpeed を使用します。これらの設定は自動進行遅延とは独立してトランジション効果を制御します。

トランジションに音声を添付してループさせることはできますか？

はい。setSound で埋め込み音声を割り当て、TransitionSoundMode の StartSound を setSoundMode に渡し、setSoundLoop に True を設定します。音声は次のサウンドイベントが発生するまでループします。

すべてのスライドに同じトランジションを適用する最速の方法は？

プレゼンテーションの getSlides コレクションをループし、各スライドのトランジションに対して同じ値で setType を呼び出します。同じループ内でタイミングや効果オプションも設定すれば、スライド全体で挙動を統一できます。

スライドに現在設定されているトランジションを確認するには？

スライドの getSlideShowTransition の結果に対して getType を呼び出します。返されるのは TransitionType 列挙からの値で、None_ はトランジション効果が適用されていないことを示します。

Python via Java でプレゼンテーションのスライドマスターを管理 Python でプレゼンテーションの描画ガイドを管理する

Python via Java を使用してプレゼンテーションのスライド トランジションを管理する