Python via Java를 사용하여 프레젠테이션에서 슬라이드 전환 관리

이 페이지의 내용

Aspose.Slides for Python via Java를 사용하여 슬라이드 전환을 적용하고 자동 슬라이드 진행을 구성하며 Morph 및 기타 전환 효과를 사용자 지정합니다.

개요

슬라이드 전환은 슬라이드 쇼 중 슬라이드가 나타나는 방식을 제어합니다. Aspose.Slides for Python via Java를 사용하면 각 슬라이드마다 전환 효과를 선택하고, 마우스 클릭 또는 타이머에 의한 진행을 구성하며, 효과별 옵션을 조정할 수 있습니다. 이 문서에서는 Python 예제를 사용하여 전환을 적용하고, 정확한 전환 지속 시간을 설정하고, 슬라이드 타이밍을 관리하며, 두 슬라이드 사이에 Morph 전환을 만드는 방법을 보여줍니다. 예제는 설정을 PPTX 파일에 저장하는 방법도 포함합니다.

슬라이드 전환 추가

전환을 적용하려면 Presentation 클래스로 프레젠테이션을 로드하고, getSlideShowTransition 를 통해 슬라이드의 전환 설정에 접근합니다. TransitionType 열거형의 값으로 setType 을 사용한 다음 프레젠테이션을 저장합니다.

다음 예제는 첫 번째 슬라이드에 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()

고급 슬라이드 전환 추가

슬라이드가 화면에 머무는 시간과 마우스 클릭으로 슬라이드 쇼를 진행할지 여부를 구성할 수 있습니다. 다음 메서드가 해당 동작을 제어합니다.

• setAdvanceOnClick 은 사용자가 마우스를 클릭하여 진행하도록 허용합니다.
• setAdvanceAfter 은 자동 진행을 활성화합니다.
• setAdvanceAfterTime 은 자동 진행 전 지연 시간을 밀리초 단위로 지정합니다.

클릭과 타이머 진행을 모두 활성화하면 사용자가 클릭하거나 타이머를 기다려 진행할 수 있습니다. 타이머만 사용하려면 setAdvanceOnClick 에 False 를 전달합니다. 지연 시간은 슬라이드 쇼가 언제 진행되는지를 결정하며, 시각적 전환 효과의 지속 시간을 설정하지는 않습니다.

이 예제는 처음 세 슬라이드에 서로 다른 효과를 할당하고, 각각 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 를 호출합니다. 저장된 지연 시간만으로는 타이머가 활성 상태인지 판단할 수 없습니다.

다음 예제는 위에서 저장한 파일을 열어 각 슬라이드의 타이머가 활성화된 경우를 보고하고, 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 열거형에서 미리 정의된 속도(느림, 보통, 빠름) 중 하나를 선택합니다. 정확한 지속 시간을 지정하지 않을 때 사용됩니다.

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밀리초, 두 번째 슬라이드에 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()

애니메이션 출력과 전환 동기화

animated GIF, HTML5 presentation, 또는 video 를 준비할 때, 내보내기 전에 정확한 전환 지속 시간을 설정하여 의도한 진행 속도와 맞추십시오. 예를 들어 장면 전환에 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 은 가능한 경우 문자 단위로 텍스트를 매치하여 애니메이션합니다.

[Morph] 전환을 선택하려면 먼저 setType 을 사용하고, 그 다음 getValue 를 호출합니다. 반환된 값은 MorphTransition 클래스의 인스턴스로, 이 클래스의 setMorphType 메서드로 매치 방식을 선택합니다.

이 예제는 이전 섹션에서 만든 프레젠테이션을 열고 두 번째 슬라이드에 단어 기반 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 카테고리(느림, 보통, 빠름)만으로 충분하고 명시적인 지속 시간이 필요 없는 경우 setSpeed 를 사용합니다. 이 설정은 자동 진행 지연과는 별개로 전환 효과를 제어합니다.

전환에 오디오를 연결하고 반복 재생할 수 있나요?

예. setSound 로 삽입된 오디오를 지정하고, TransitionSoundMode 열거형의 StartSound 를 setSoundMode 에 전달한 뒤, setSoundLoop 에 True 를 설정합니다. 오디오는 슬라이드 쇼에서 다음 사운드 이벤트가 발생할 때까지 반복됩니다.

모든 슬라이드에 동일한 전환을 가장 빠르게 적용하는 방법은?

프레젠테이션의 getSlides 컬렉션을 순회하면서 각 슬라이드의 전환에 대해 동일한 값으로 setType 을 호출합니다. 같은 루프 내에서 타이밍 및 효과 옵션도 설정하면 슬라이드 간 동작이 일관됩니다.

슬라이드에 현재 설정된 전환을 확인하려면?

슬라이드의 getSlideShowTransition 결과에 대해 getType 을 호출하십시오. 반환값은 TransitionType 열거형 중 하나이며, None_ 은 전환 효과가 적용되지 않았음을 의미합니다.