Java에서 로우코드 프레젠테이션 작업

개요

com.aspose.slides 패키지는 일반적인 프레젠테이션 작업을 위한 정적 헬퍼 클래스를 제공합니다. 이 헬퍼들은 자주 사용되는 객체 모델 워크플로우를 집중된 메서드로 래핑하여 파일을 변환하거나 병합하고, 프레젠테이션 요소를 처리하며, 도형을 수집하고, 사용되지 않는 콘텐츠를 적은 코드로 제거할 수 있게 합니다.

Low-code 헬퍼는 작업이 전체 파일이나 프레젠테이션에 적용되고 기본 워크플로우가 요구사항에 맞을 때 가장 유용합니다. 개별 슬라이드, 마스터, 레이아웃, 도형, 내보내기 설정 또는 프레젠테이션 요소 간 관계에 대한 세밀한 제어가 필요할 경우 전체 Aspose.Slides object model을 사용하십시오.

다음 표는 사용 가능한 헬퍼를 요약한 것입니다:

Helper Use it for
Convert 파일을 다른 형식으로 직접 변환합니다.
Merger 동일한 형식의 프레젠테이션 파일을 결합합니다.
ForEach 각 슬라이드, 도형, 단락, 텍스트 부분에 대해 작업을 수행합니다.
Collect 전체 프레젠테이션에서 도형을 가져와 반복 처리하거나 분석합니다.
Compress 사용되지 않는 마스터와 레이아웃을 제거하고 포함된 글꼴 데이터를 축소합니다.

프레젠테이션 변환

Convert.autoByExtension을 사용하면 출력 파일 확장자만으로 내보내기 형식을 결정할 수 있습니다. 메서드는 원본 프레젠테이션을 열고, 출력 경로에서 필요한 형식을 판단한 뒤 결과를 작성합니다.

import com.aspose.slides.Convert;

Convert.autoByExtension("input.pptx", "output.pdf");

Convert 클래스는 PDF, SVG, JPEG, PNG, TIFF 출력 전용 메서드도 제공합니다. 내보내기 전에 프레젠테이션을 검사하거나 수정하거나, 선택된 헬퍼가 제공하지 않는 내보내기 옵션을 구성해야 할 경우 전체 객체 모델을 사용하십시오. 형식별 워크플로와 옵션은 Convert Presentation를 참고하세요.

프레젠테이션 병합

Merger.process를 사용하면 한 번의 호출로 전체 프레젠테이션 파일을 결합할 수 있습니다. 입력 프레젠테이션은 동일한 파일 형식이어야 합니다.

import com.aspose.slides.Merger;

String[] inputFiles = { "part-1.pptx", "part-2.pptx" };
Merger.process(inputFiles, "merged.pptx");

모든 슬라이드를 개별 선택이나 재매핑 없이 하나의 결과에 추가해야 할 경우 이 헬퍼가 적합합니다. 선택된 슬라이드를 병합하거나, 대상 마스터 또는 레이아웃을 적용하거나, 섹션을 명시적으로 보존하거나, 서로 다른 슬라이드 크기를 조정해야 할 경우 전체 객체 모델을 사용하십시오. 이러한 시나리오는 Merge Presentations를 참고하십시오.

프레젠테이션 요소 반복

ForEach 클래스는 요청된 유형의 프레젠테이션 요소마다 콜백을 호출합니다. 중첩된 컬렉션 반복을 피하고 프레젠테이션 전체에 대한 검사 또는 서식 변경에 편리합니다.

다음 예제는 ForEach.slide, ForEach.shape, ForEach.paragraph, 및 ForEach.portion를 사용하여 해당 요소를 검사합니다:

import com.aspose.slides.*;

Presentation presentation = new Presentation("input.pptx");
try {
    ForEach.slide(presentation, (slide, index) -> {
        System.out.println(String.format("Slide %d: %d shapes", index, slide.getShapes().size()));
    });

    ForEach.shape(presentation, (shape, slide, index) -> {
        System.out.println(String.format("Shape %d on %s: %s", index, slide.getClass().getSimpleName(), shape.getName()));
    });

    ForEach.paragraph(presentation, (paragraph, slide, index) -> {
        System.out.println(String.format("Paragraph %d on %s: %s", index, slide.getClass().getSimpleName(), paragraph.getText()));
    });

    ForEach.portion(presentation, (portion, paragraph, slide, index) -> {
        System.out.println(String.format("Portion %d on %s: %s", index, slide.getClass().getSimpleName(), portion.getText()));
    });
} finally {
    presentation.dispose();
}

기본적으로 프레젠테이션 전체의 도형 및 텍스트 순회에는 일반 슬라이드, 마스터 슬라이드, 레이아웃 슬라이드가 포함됩니다. includeNotes 매개변수가 있는 오버로드를 사용하면 노트 슬라이드도 처리할 수 있습니다. 순회 순서, 조기 종료, 콜백 호출 전에 필터링이 필요하거나 부모‑자식 관계에 대한 세부 제어가 중요한 경우 직접 컬렉션 루프를 사용하십시오.

도형 수집

Collect.shapes을 사용하면 각 도형에 대한 콜백 대신 프레젠테이션 전체의 도형 컬렉션을 얻을 수 있습니다. 동일한 도형 집합을 여러 번 필터링, 계산하거나 처리해야 할 때 유용합니다.

import com.aspose.slides.*;

Presentation presentation = new Presentation("input.pptx");
try {
    Iterable<Shape> shapes = Collect.shapes(presentation);

    for (Shape shape : shapes) {
        System.out.println(String.format("%s: %s", shape.getName(), shape.getClass().getSimpleName()));
    }
} finally {
    presentation.dispose();
}

각 도형을 즉시 처리하고 수집 결과를 유지할 필요가 없을 경우에는 대신 ForEach.shape를 사용하십시오.

프레젠테이션 콘텐츠 압축

Compress 클래스는 사용되지 않는 구조 요소를 제거하고 포함된 글꼴 데이터를 축소할 수 있습니다:

import com.aspose.slides.*;

Presentation presentation = new Presentation("input.pptx");
try {
    Compress.removeUnusedLayoutSlides(presentation);
    Compress.removeUnusedMasterSlides(presentation);
    Compress.compressEmbeddedFonts(presentation);

    presentation.save("compressed.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

레이아웃 정리 후에 참조되지 않게 된 마스터도 제거될 수 있도록 사용되지 않는 레이아웃을 먼저 제거하십시오. 나중에 원본 마스터, 레이아웃 또는 전체 포함 글꼴 데이터가 필요할 수 있다면 최적화된 프레젠테이션을 새 파일에 저장하십시오. 자세한 내용은 Slide Master와 Embedded Font를 참고하십시오.

FAQ

전체 객체 모델 대신 로우코드 API를 언제 사용해야 하나요?

Low-code 헬퍼는 표준 작업이 전체 파일이나 프레젠테이션에 적용되고 개별 요소에 대한 세부 제어가 필요하지 않을 때 사용합니다. 개별 슬라이드 선택, 마스터 및 레이아웃 관계 제어, 중간 상태 검사, 헬퍼가 제공하지 않는 동작 구성 등이 필요할 경우 전체 객체 모델을 사용하십시오.

Merger가 서로 다른 파일 형식의 프레젠테이션을 결합할 수 있나요?

아니요. [Merger.process]는 입력 프레젠테이션이 동일한 형식이어야 합니다. 먼저 Convert.autoByExtension을 사용해 공통 형식으로 변환한 뒤 결합하십시오.

ForEach가 마스터, 레이아웃 및 노트 슬라이드를 처리합니까?

[ForEach.slide]은 일반 프레젠테이션 슬라이드만 순회합니다. 프레젠테이션 전체에 대해 [ForEach.shape], [ForEach.paragraph], [ForEach.portion] 연산은 기본적으로 일반, 마스터, 레이아웃 슬라이드를 포함합니다. includeNotes 파라미터를 true로 설정하면 노트 슬라이드도 포함됩니다.

ForEach.shape와 Collect.shapes의 차이점은 무엇인가요?

[ForEach.shape]는 콜백을 통해 각 도형을 즉시 처리합니다. [Collect.shapes]는 도형 컬렉션을 반환하여 보관, 필터링, 계산 또는 여러 번 순회할 수 있게 합니다.

Compress가 항상 프레젠테이션 파일을 더 작게 만들까요?

반드시 그렇지는 않습니다. 프레젠테이션에 사용되지 않는 레이아웃, 마스터, 사용되지 않은 글꼴 문자 등이 포함되어 있을 때만 파일 크기가 감소합니다. 해당 요소가 없으면 [Compress] 작업이 파일 크기를 줄이지 않을 수 있습니다.

ForEach 또는 Compress로 만든 변경 사항이 자동으로 저장되나요?

아니요. 이 헬퍼들은 메모리상의 [Presentation] 객체에만 적용됩니다. [ForEach] 콜백이나 [Compress] 실행 후에는 [Presentation.save]를 호출해 결과를 저장해야 합니다.

관련 문서

Java에서 프레젠테이션을 효율적으로 병합하기 Java에서 PDF 또는 HTML로 프레젠테이션 가져오기