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

이 페이지의 내용

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

개요

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

슬라이드 전환 추가

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

다음 예제는 첫 번째 슬라이드에 Circle 전환을, 두 번째 슬라이드에 Comb 전환을 적용합니다. 슬라이드가 두 개 이상 포함된 input.pptx 파일을 사용하십시오.

const slides = require("aspose.slides.via.java");

const presentation = new slides.Presentation("input.pptx");
try {
    if (presentation.getSlides().size() >= 2) {
        presentation.getSlides().get_Item(0).getSlideShowTransition().setType(slides.TransitionType.Circle);
        presentation.getSlides().get_Item(1).getSlideShowTransition().setType(slides.TransitionType.Comb);

        presentation.save("slide-transitions.pptx", slides.SaveFormat.Pptx);
    } else {
        console.log("The input presentation must contain at least two slides.");
    }
} finally {
    presentation.dispose();
}

고급 슬라이드 전환 추가

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

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

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

다음 예제는 첫 번째 세 슬라이드에 서로 다른 효과를 할당하고 각각 3초, 5초, 7초 후에 자동 진행되도록 설정합니다. 마우스 클릭으로도 슬라이드를 진행할 수 있습니다. 슬라이드가 세 개 이상 포함된 input.pptx 파일을 사용하십시오.

const slides = require("aspose.slides.via.java");

const presentation = new slides.Presentation("input.pptx");
try {
    if (presentation.getSlides().size() >= 3) {
        const firstTransition = presentation.getSlides().get_Item(0).getSlideShowTransition();
        firstTransition.setType(slides.TransitionType.Circle);
        firstTransition.setAdvanceOnClick(true);
        firstTransition.setAdvanceAfter(true);
        firstTransition.setAdvanceAfterTime(3000);

        const secondTransition = presentation.getSlides().get_Item(1).getSlideShowTransition();
        secondTransition.setType(slides.TransitionType.Comb);
        secondTransition.setAdvanceOnClick(true);
        secondTransition.setAdvanceAfter(true);
        secondTransition.setAdvanceAfterTime(5000);

        const thirdTransition = presentation.getSlides().get_Item(2).getSlideShowTransition();
        thirdTransition.setType(slides.TransitionType.Zoom);
        thirdTransition.setAdvanceOnClick(true);
        thirdTransition.setAdvanceAfter(true);
        thirdTransition.setAdvanceAfterTime(7000);

        presentation.save("advanced-transitions.pptx", slides.SaveFormat.Pptx);
    } else {
        console.log("The input presentation must contain at least three slides.");
    }
} finally {
    presentation.dispose();
}

타이머 진행이 활성화되었는지 확인하려면 getAdvanceAfter를 호출합니다. 저장된 지연 시간만으로는 타이머가 활성 상태인지 판단할 수 없습니다.

다음 예제는 위에서 저장한 파일을 열어 각 슬라이드의 타이머가 활성화되었는지 보고, 2초보다 큰 지연 시간을 가진 슬라이드의 자동 진행을 비활성화하고 클릭 진행을 활성화한 뒤 설정을 저장합니다.

const slides = require("aspose.slides.via.java");

const presentation = new slides.Presentation("advanced-transitions.pptx");
try {
    for (let i = 0; i < presentation.getSlides().size(); i++) {
        const slide = presentation.getSlides().get_Item(i);
        const transition = slide.getSlideShowTransition();

        if (transition.getAdvanceAfter()) {
            console.log("Slide " + slide.getSlideNumber() + ": advance after " + transition.getAdvanceAfterTime() + " ms.");

            if (transition.getAdvanceAfterTime() > 2000) {
                transition.setAdvanceAfter(false);
                transition.setAdvanceOnClick(true);
            }
        }
    }

    presentation.save("adjusted-transitions.pptx", slides.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로 저장합니다.

const slides = require("aspose.slides.via.java");

const presentation = new slides.Presentation("input.pptx");
try {
    for (let i = 0; i < presentation.getSlides().size(); i++) {
        const slide = presentation.getSlides().get_Item(i);
        const transition = slide.getSlideShowTransition();
        transition.setType(slides.TransitionType.Fade);
        transition.setDuration(750);

        // 효과 지속 시간과 별도로 자동 진행을 구성합니다.
        transition.setAdvanceAfter(true);
        transition.setAdvanceAfterTime(5000);
        transition.setAdvanceOnClick(false);
    }

    presentation.save("precise-transitions.pptx", slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

개별 슬라이드에 다른 지속 시간 설정

슬라이드마다 다른 효과 지속 시간을 사용할 수 있습니다. 예를 들어 제목 슬라이드에는 짧은 전환을, 섹션 도입 슬라이드에는 긴 전환을 적용합니다. 이 예제는 첫 번째 슬라이드에 500밀리초, 두 번째 슬라이드에 1,200밀리초를 설정합니다. 최소 두 개의 슬라이드가 포함된 input.pptx 파일을 사용하십시오.

const slides = require("aspose.slides.via.java");

const presentation = new slides.Presentation("input.pptx");
try {
    if (presentation.getSlides().size() >= 2) {
        const firstTransition = presentation.getSlides().get_Item(0).getSlideShowTransition();
        firstTransition.setType(slides.TransitionType.Fade);
        firstTransition.setDuration(500);

        const secondTransition = presentation.getSlides().get_Item(1).getSlideShowTransition();
        secondTransition.setType(slides.TransitionType.Push);
        secondTransition.setDuration(1200);

        presentation.save("individual-transition-durations.pptx", slides.SaveFormat.Pptx);
    } else {
        console.log("The input presentation must contain at least two slides.");
    }
} finally {
    presentation.dispose();
}

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

animated GIF, HTML5 presentation, 또는 video를 준비할 때는 내보내기 전에 정확한 전환 지속 시간을 설정해 의도한 템포와 맞추십시오. 예를 들어 장면 간에 600밀리초 페이드를 사용하고, 각 슬라이드의 진행 지연을 별도로 조정해 내레이션이나 콘텐츠가 재생될 시간을 확보합니다.

GIF와 비디오의 경우 효과 지속 시간에 맞춰 출력 프레임 레이트를 조정하십시오: 600밀리초는 30fps에서 18프레임에 해당합니다. HTML5에서는 내보내기 설정에서 애니메이션 전환을 활성화합니다. 선택한 내보내기 형식이 지원하는 효과와 타이밍 옵션을 확인하고, 출력 결과를 미리 보아 동기화를 검증하십시오.

기존 전환 지속 시간 읽기

전환을 수정하기 전에 getDuration을 호출해 명시적인 값이 저장돼 있는지 확인합니다. -1은 명시적인 지속 시간이 설정되지 않았음을 의미하고, 0 이상 값은 밀리초 단위로 저장된 지속 시간을 나타냅니다. 이 값은 계산된 재생 지속 시간이 아니며, Aspose.Slides는 전환 유형과 getSpeed 값을 사용해 해당 지속 시간을 결정합니다. 전환 유형을 설정하면 지속 시간이 초기화될 수 있으므로, 먼저 원본 설정을 확인하십시오.

const slides = require("aspose.slides.via.java");

const presentation = new slides.Presentation("input.pptx");
try {
    for (let i = 0; i < presentation.getSlides().size(); i++) {
        const slide = presentation.getSlides().get_Item(i);
        const transition = slide.getSlideShowTransition();
        const duration = transition.getDuration();

        if (duration >= 0) {
            console.log("Slide " + slide.getSlideNumber() + ": stored transition duration is " + duration + " ms.");
        } else {
            console.log("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를 지원하는 프레젠테이션 뷰어에서 저장된 파일을 열어 슬라이드 쇼 중 효과를 확인하십시오.

const slides = require("aspose.slides.via.java");

const presentation = new slides.Presentation();
try {
    const firstSlide = presentation.getSlides().get_Item(0);
    const rectangle = firstSlide.getShapes().addAutoShape(slides.ShapeType.Rectangle, 100, 100, 400, 100);
    rectangle.getTextFrame().setText("Morph transition");

    const secondSlide = presentation.getSlides().addClone(firstSlide);
    const movedRectangle = secondSlide.getShapes().get_Item(0);
    movedRectangle.setX(movedRectangle.getX() + 100);
    movedRectangle.setY(movedRectangle.getY() + 50);
    movedRectangle.setWidth(movedRectangle.getWidth() - 200);
    movedRectangle.setHeight(movedRectangle.getHeight() - 10);

    secondSlide.getSlideShowTransition().setType(slides.TransitionType.Morph);

    presentation.save("morph-transition.pptx", slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Morph 전환 유형

TransitionMorphType 열거형은 Morph가 콘텐츠를 매칭하고 애니메이션하는 방식을 제어합니다.

ByObject 은 각 도형을 전체 객체로 취급합니다.
ByWord 은 가능한 경우 단어 단위로 텍스트를 매칭해 애니메이션합니다.
ByChar 은 가능한 경우 문자 단위로 텍스트를 매칭해 애니메이션합니다.

[Morph]를 선택하려면 setType으로 Morph를 지정한 뒤 getValue에 접근합니다. 반환된 값은 MorphTransition 객체를 제공하며, 이 객체의 setMorphType 메서드로 매칭 모드를 선택합니다.

다음 예제는 이전 섹션에서 만든 프레젠테이션을 열어 두 번째 슬라이드에 단어 기반 Morph 애니메이션을 구성합니다.

const java = require("java");
const slides = require("aspose.slides.via.java");

const presentation = new slides.Presentation("morph-transition.pptx");
try {
    if (presentation.getSlides().size() >= 2) {
        const transition = presentation.getSlides().get_Item(1).getSlideShowTransition();
        transition.setType(slides.TransitionType.Morph);
        const transitionValue = transition.getValue();

        if (java.instanceOf(transitionValue, "com.aspose.slides.IMorphTransition")) {
            transitionValue.setMorphType(slides.TransitionMorphType.ByWord);
            presentation.save("morph-by-word.pptx", slides.SaveFormat.Pptx);
        } else {
            console.log("Morph transition options are unavailable.");
        }
    } else {
        console.log("The input presentation must contain at least two slides.");
    }
} finally {
    presentation.dispose();
}

전환 효과 설정

일부 전환은 방향이나 검은 화면에서 시작 여부와 같은 추가 옵션을 제공합니다. 사용 가능한 옵션은 setType으로 선택한 전환에 따라 달라집니다. 먼저 유형을 설정한 뒤, getValue에서 반환되는 적절한 전환 객체를 사용하십시오.

다음 예제는 input.pptx의 첫 번째 슬라이드에 Cut 전환을 적용합니다. OptionalBlackTransition을 통해 setFromBlack을 호출해 전환이 검은 화면에서 시작하도록 합니다.

const java = require("java");
const slides = require("aspose.slides.via.java");

const presentation = new slides.Presentation("input.pptx");
try {
    const transition = presentation.getSlides().get_Item(0).getSlideShowTransition();
    transition.setType(slides.TransitionType.Cut);
    const transitionValue = transition.getValue();

    if (java.instanceOf(transitionValue, "com.aspose.slides.IOptionalBlackTransition")) {
        transitionValue.setFromBlack(true);
        presentation.save("cut-from-black.pptx", slides.SaveFormat.Pptx);
    } else {
        console.log("Cut transition options are unavailable.");
    }
} finally {
    presentation.dispose();
}

FAQ

슬라이드 전환의 재생 속도를 제어할 수 있나요?

네. 정확한 효과 지속 시간을 밀리초 단위로 지정해야 할 경우 setDuration을 사용하십시오. 미리 정의된 TransitionSpeed 카테고리(느림, 보통, 빠름)만으로 충분하고 명시적인 지속 시간이 필요하지 않은 경우 setSpeed를 사용하십시오. 이러한 설정은 자동 진행 지연과는 별도로 전환 효과만을 제어합니다.

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

네. setSound으로 내장 오디오를 지정하고, TransitionSoundMode 열거형의 StartSound 값을 setSoundMode에 전달한 뒤 setSoundLoop을 true로 설정하면 됩니다. 오디오는 슬라이드 쇼의 다음 사운드 이벤트가 발생할 때까지 반복 재생됩니다.

모든 슬라이드에 동일한 전환을 가장 빠르게 적용하려면 어떻게 해야 하나요?

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

슬라이드에 현재 설정된 전환을 확인하려면 어떻게 하나요?

슬라이드의 getSlideShowTransition 결과에 대해 getType을 호출합니다. 반환값은 TransitionType 열거형의 값이며, None이면 전환 효과가 적용되지 않은 것입니다.

JavaScript에서 프레젠테이션 슬라이드 크기 변경 JavaScript에서 프레젠테이션의 그리기 가이드 관리