PHP에서 프레젠테이션을 효율적으로 병합하기

이 페이지의 내용

PHP에서 슬라이드를 복제하고, 마스터와 레이아웃을 제어하며, 슬라이드 내용을 크기 조정하고, 섹션을 보존하고, 보호된 파일이나 대용량 파일을 처리하면서 PowerPoint 및 OpenDocument 프레젠테이션을 병합하는 방법을 배웁니다.

개요

Aspose.Slides for PHP via Java은 하나의 Presentation에서 슬라이드를 복제하여 다른 프레젠테이션에 병합합니다. 주요 작업은 SlideCollection::addClone()이며, 소스 슬라이드의 서식을 유지하거나 복제된 슬라이드를 대상 프레젠테이션의 마스터 또는 레이아웃에 연결할 수 있습니다.

이 문서는 가장 일반적인 병합 워크플로우를 다룹니다:

• 소스 서식을 유지하면서 모든 슬라이드 병합;
• 선택된 슬라이드 병합;
• 대상 프레젠테이션의 마스터 적용;
• 대상 프레젠테이션의 특정 레이아웃 적용;
• 병합 전에 서로 다른 슬라이드 크기 정규화;
• 섹션에 복제된 슬라이드 추가;
• 하나의 엔드‑투‑엔드 워크플로우에서 여러 프레젠테이션 병합;
• 마스터, 리소스, 노트, 댓글, 미디어, 글꼴, 비밀번호, 대용량 파일 및 멀티스레딩 문제 처리.

슬라이드 복제가 마스터 및 레이아웃에 미치는 영향

슬라이드는 레이아웃과 마스터에서 많은 외관을 상속합니다. 따라서 선택한 복제 오버로드에 따라 병합된 슬라이드가 대상 프레젠테이션에 어떻게 통합되는지가 결정됩니다.

다음과 같은 방식으로 SlideCollection::addClone()을 사용합니다:

• addClone(sourceSlide) — 소스 슬라이드의 레이아웃과 서식을 유지합니다. 필요한 경우 소스 마스터가 자동으로 대상 프레젠테이션에 복제될 수 있습니다. Aspose.Slides는 자동 복제된 마스터를 추적하여 동일한 소스 마스터를 사용하는 반복 슬라이드가 마스터를 여러 번 복제하지 않도록 합니다.
• addClone(sourceSlide, destinationMaster, allowCloneMissingLayout) — 복제된 슬라이드를 특정 대상 MasterSlide에 연결합니다. Aspose.Slides는 레이아웃 유형이나 이름으로 해당 마스터 아래 일치하는 레이아웃을 찾습니다.
• addClone(sourceSlide, destinationLayout) — 복제된 슬라이드를 특정 대상 LayoutSlide에 직접 연결합니다.

addClone 오버로드에 전달되는 마스터 또는 레이아웃은 대상 프레젠테이션에 속해야 하며, 소스 프레젠테이션에 속해서는 안 됩니다.

전체 프레젠테이션 병합 및 소스 서식 유지

가장 간단한 병합은 소스 프레젠테이션의 모든 슬라이드를 대상 프레젠테이션으로 복사합니다. 가져온 슬라이드가 원본 테마, 마스터 및 레이아웃 관계를 유지해야 할 때 적합한 선택입니다.

require_once("Java.inc");
require_once("lib/aspose.slides.php");

use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

$destination = new Presentation("destination.pptx");
try {
    $source = new Presentation("source.pptx");
    try {
        foreach ($source->getSlides() as $slide) {
            $destination->getSlides()->addClone($slide);
        }
    } finally {
        $source->dispose();
    }

    $destination->save("merged.pptx", SaveFormat::Pptx);
} finally {
    $destination->dispose();
}

소스와 대상가 서로 다른 디자인을 사용할 경우 결과 프레젠테이션에 여러 마스터가 포함될 수 있습니다. 이는 소스 서식을 의도적으로 유지할 때 기대되는 동작입니다.

선택된 슬라이드 병합

모든 슬라이드를 복제할 필요는 없습니다. 다음 예제는 소스 프레젠테이션에서 선택된 슬라이드 인덱스만 가져옵니다.

require_once("Java.inc");
require_once("lib/aspose.slides.php");

use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

$destination = new Presentation("destination.pptx");
try {
    $source = new Presentation("source.pptx");
    try {
        $slideIndexes = [0, 2, 4];

        foreach ($slideIndexes as $index) {
            $destination->getSlides()->addClone($source->getSlides()->get_Item($index));
        }
    } finally {
        $source->dispose();
    }

    $destination->save("merged-selected-slides.pptx", SaveFormat::Pptx);
} finally {
    $destination->dispose();
}

사용자 입력이나 외부 설정에서 가져온 경우 복제하기 전에 슬라이드 인덱스를 검증하십시오.

대상 마스터를 사용하여 슬라이드 병합

가져온 슬라이드가 이미 대상 프레젠테이션에 존재하는 마스터를 따라야 할 경우 addClone(Slide, MasterSlide, boolean) 오버로드를 사용합니다.

require_once("Java.inc");
require_once("lib/aspose.slides.php");

use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

$destination = new Presentation("destination.pptx");
try {
    $source = new Presentation("source.pptx");
    try {
        $destinationMaster = $destination->getMasters()->get_Item(0);

        foreach ($source->getSlides() as $slide) {
            $destination->getSlides()->addClone($slide, $destinationMaster, true);
        }
    } finally {
        $source->dispose();
    }

    $destination->save("merged-with-destination-master.pptx", SaveFormat::Pptx);
} finally {
    $destination->dispose();
}

Aspose.Slides는 소스 레이아웃의 유형 또는 이름과 일치하는 적절한 레이아웃을 지정된 마스터 아래에서 선택합니다. 적합한 레이아웃이 없고 allowCloneMissingLayout이 true이면 소스 레이아웃이 복제되어 슬라이드를 추가할 수 있게 됩니다. false인 경우 PptxEditException이 발생합니다.

대상 마스터에 추가 레이아웃을 도입하고 싶지 않고 병합이 실패하도록 하려면 false를 사용하십시오.

특정 대상 레이아웃을 사용하여 슬라이드 병합

가져온 슬라이드가 정확히 어떤 대상 레이아웃을 사용해야 하는지 알고 있는 경우 addClone(Slide, LayoutSlide) 오버로드를 사용합니다.

require_once("Java.inc");
require_once("lib/aspose.slides.php");

use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

$destination = new Presentation("destination.pptx");
try {
    $source = new Presentation("source.pptx");
    try {
        $destinationLayout = $destination->getLayoutSlides()->get_Item(0);

        foreach ($source->getSlides() as $slide) {
            $destination->getSlides()->addClone($slide, $destinationLayout);
        }
    } finally {
        $source->dispose();
    }

    $destination->save("merged-with-destination-layout.pptx", SaveFormat::Pptx);
} finally {
    $destination->dispose();
}

대상 레이아웃을 적용하면 상속된 레이아웃 관계가 변경되지만 소스 슬라이드 내용 자체가 재설계되지는 않습니다. 소스와 대상 레이아웃의 자리표시자 구조가 다르면 결과를 확인하여 상속된 서식 및 자리표시자 동작이 적절한지 검증하십시오.

다른 슬라이드 크기를 가진 프레젠테이션 병합

슬라이드 크기가 다른 프레젠테이션도 병합할 수 있지만, 슬라이드를 다른 크기의 프레젠테이션에 복제한다고 해서 내용이 자동으로 새 캔버스에 맞게 재설계되는 것은 아닙니다. 따라서 도형이 이동하거나, 예상치 못하게 스케일되거나, 보이는 영역 밖에 표시될 수 있습니다.

실용적인 방법은 복제하기 전에 소스 프레젠테이션의 크기를 조정하는 것입니다. SlideSize::setSize() 메서드는 슬라이드 차원을 변경하면서 기존 콘텐츠를 스케일링할 수 있습니다. SlideSizeScaleType::EnsureFit은 요청된 크기에 맞게 콘텐츠를 스케일합니다.

require_once("Java.inc");
require_once("lib/aspose.slides.php");

use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\SlideSizeScaleType;

$destination = new Presentation("destination.pptx");
try {
    $source = new Presentation("source.pptx");
    try {
        $sourceWidth = java_values($source->getSlideSize()->getSize()->getWidth());
        $sourceHeight = java_values($source->getSlideSize()->getSize()->getHeight());
        $destinationWidth = java_values($destination->getSlideSize()->getSize()->getWidth());
        $destinationHeight = java_values($destination->getSlideSize()->getSize()->getHeight());

        if ($sourceWidth != $destinationWidth || $sourceHeight != $destinationHeight) {
            $source->getSlideSize()->setSize($destinationWidth, $destinationHeight, SlideSizeScaleType::EnsureFit);
        }

        foreach ($source->getSlides() as $slide) {
            $destination->getSlides()->addClone($slide);
        }
    } finally {
        $source->dispose();
    }

    $destination->save("merged-same-slide-size.pptx", SaveFormat::Pptx);
} finally {
    $destination->dispose();
}

크기 조정은 메모리상의 소스 프레젠테이션 객체를 변경합니다. 다른 작업을 위해 원본 소스 프레젠테이션을 그대로 유지해야 하면 병합용으로 별도의 인스턴스를 열어 사용하십시오.

프레젠테이션 섹션에 슬라이드 병합

기본 슬라이드 복제 루프는 소스 프레젠테이션의 섹션 계층 구조를 재생성하지 못합니다. 출력에서 섹션이 중요한 경우 대상 프레젠테이션에서 섹션을 생성하거나 선택하고 addClone(Slide, Section)을 사용해 명시적으로 슬라이드를 해당 섹션에 복제하십시오.

require_once("Java.inc");
require_once("lib/aspose.slides.php");

use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

$destination = new Presentation("destination.pptx");
try {
    $source = new Presentation("source.pptx");
    try {
        $importedSection = $destination->getSections()->appendEmptySection("Imported slides");

        foreach ($source->getSlides() as $slide) {
            $destination->getSlides()->addClone($slide, $importedSection);
        }
    } finally {
        $source->dispose();
    }

    $destination->save("merged-with-section.pptx", SaveFormat::Pptx);
} finally {
    $destination->dispose();
}

복제된 슬라이드는 지정된 대상 섹션에 추가됩니다. 여러 소스 섹션을 보존하려면 Presentation::getSections를 열거하고, 각 소스 섹션의 현재 슬라이드를 Section::getSlidesListOfSection으로 가져온 뒤, 대상에 섹션을 재생성하고 반환된 각 슬라이드를 해당 대상 섹션에 복제합니다. 전체 섹션 열거 예제와 빈 섹션 및 구조 변경 내용은 Manage Slide Sections을 참고하십시오.

다수의 프레젠테이션을 안전하게 병합

다음 엔드‑투‑엔드 예제는 첫 번째 프레젠테이션을 대상으로 사용하고, 각 추가 소스의 슬라이드 크기를 정규화하며, 복제 중에만 각 소스를 열어 두고, 마지막에 한 번만 파일을 저장합니다.

require_once("Java.inc");
require_once("lib/aspose.slides.php");

use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\SlideSizeScaleType;

$inputFiles = ["part1.pptx", "part2.pptx", "part3.pptx"];

$merged = new Presentation($inputFiles[0]);
try {
    $mergedWidth = java_values($merged->getSlideSize()->getSize()->getWidth());
    $mergedHeight = java_values($merged->getSlideSize()->getSize()->getHeight());

    for ($fileIndex = 1; $fileIndex < count($inputFiles); $fileIndex++) {
        $source = new Presentation($inputFiles[$fileIndex]);
        try {
            $sourceWidth = java_values($source->getSlideSize()->getSize()->getWidth());
            $sourceHeight = java_values($source->getSlideSize()->getSize()->getHeight());

            if ($sourceWidth != $mergedWidth || $sourceHeight != $mergedHeight) {
                $source->getSlideSize()->setSize($mergedWidth, $mergedHeight, SlideSizeScaleType::EnsureFit);
            }

            foreach ($source->getSlides() as $slide) {
                $merged->getSlides()->addClone($slide);
            }
        } finally {
            $source->dispose();
        }
    }

    $merged->save("merged.pptx", SaveFormat::Pptx);
} finally {
    $merged->dispose();
}

이 방법은 가져온 슬라이드의 소스 서식을 보존하기 위한 유용한 기본선입니다. 출력에 단일 대상 테마를 사용해야 할 경우 앞서 소개한 대상 마스터 또는 대상 레이아웃 오버로드로 addClone($slide) 호출을 교체하십시오.

실용적인 고려 사항

마스터, 레이아웃 및 서식 정확도

기본 슬라이드 복제는 필요한 소스 마스터를 자동으로 대상 프레젠테이션에 가져올 수 있습니다. Aspose.Slides는 동일한 마스터가 반복 복제되는 것을 방지하기 위해 자동 복제된 마스터를 내부 레지스트리로 관리합니다. 수동으로 복제한 마스터는 해당 레지스트리에 등록되지 않으므로, 마스터 구조에 대한 명시적 제어가 필요하지 않은 한 사전 복제를 피하십시오.

같은 이름을 가진 두 마스터 또는 레이아웃이 시각적으로 동일하다고 가정하지 마십시오. 기업 템플릿이 최종 모양을 제어해야 한다면 대상 마스터 또는 레이아웃을 명시적으로 선택하고 병합 후 결과를 검증하십시오.

노트 및 댓글

스피커 노트와 슬라이드 댓글은 슬라이드 콘텐츠와 연결되어 있으며 슬라이드가 복제될 때 복사됩니다. Aspose.Slides는 또한 presentation notes와 presentation comments에 대한 전용 API를 제공합니다.

노트 페이지 서식이 중요한 경우, 노트 마스터가 프레젠테이션 수준 객체이므로 소스 파일 간에 다를 수 있음을 고려해 병합된 프레젠테이션을 확인하십시오. 검토 워크플로우에서는 서로 다른 저자 또는 템플릿의 파일을 결합한 후 댓글 작성자와 스레드형 댓글도 검증하십시오.

이미지, 오디오, 비디오, OLE 개체 및 외부 링크

슬라이드는 이미지, 내장 오디오, 내장 비디오 및 OLE 데이터와 같은 프레젠테이션 수준 리소스를 참조할 수 있습니다. 슬라이드 자체를 복제하고 보이는 도형만 복사하지 않아야 Aspose.Slides가 리소스와의 관계를 유지할 수 있습니다.

내장 리소스와 링크된 리소스는 다르게 취급해야 합니다. 링크된 오디오, 비디오, OLE 개체 또는 하이퍼링크는 외부 대상에 의존하며, 슬라이드를 복제해도 외부 링크가 내장 콘텐츠로 바뀌지는 않습니다. 병합된 프레젠테이션이 열릴 환경에서 링크된 리소스 경로와 URL을 테스트하십시오.

Aspose.Slides는 자동 복제된 마스터를 명시적으로 추적하지만, 이는 서로 다른 소스 프레젠테이션에서 동일한 바이너리 리소스가 항상 중복 제거된다는 일반적인 보증으로 해석해서는 안 됩니다. 출력 파일 크기가 중요한 경우, 병합된 패키지를 검사하고 결과를 측정하여 암시적 중복 제거에 의존하지 마십시오.

임베디드 폰트 및 폰트 가용성

폰트는 프레젠테이션 수준에서 관리됩니다. 타이포그래피가 기기 간에 일관되어야 한다면 슬라이드 복제만으로 모든 필요한 폰트가 대상 환경에 존재한다고 가정하지 마십시오. FontsManager::getEmbeddedFonts()를 사용해 임베디드 폰트를 확인하고, Embed Fonts in Presentations에 설명된 대로 임베딩을 명시적으로 관리하십시오.

또한 소스 파일에서 사용된 폰트를 임베드할 수 있는 권한이 있는지 확인하십시오. 폰트 라이선스는 임베딩을 제한할 수 있습니다.

비밀번호 보호 프레젠테이션

비밀번호가 설정된 소스는 슬라이드를 복제하기 전에 성공적으로 열어야 합니다. 비밀번호는 LoadOptions::setPassword()를 통해 제공하십시오.

require_once("Java.inc");
require_once("lib/aspose.slides.php");

use aspose\slides\LoadOptions;
use aspose\slides\Presentation;

$loadOptions = new LoadOptions();
$loadOptions->setPassword("YOUR_PASSWORD");

$source = new Presentation("protected.pptx", $loadOptions);
try {
    // 복호화된 프레젠테이션을 사용하여 작업합니다.
} finally {
    $source->dispose();
}

암호화된 소스를 열었다고 해서 동일한 보호가 자동으로 대상 프레젠테이션에 적용되는 것은 아닙니다. 필요한 경우 출력 보호를 별도로 구성하십시오.

대용량 프레젠테이션 및 메모리 사용

고해상도 이미지, 오디오, 비디오 또는 기타 대용량 바이너리 객체를 포함하는 대용량 프레젠테이션은 상당한 메모리를 소모할 수 있습니다. LoadOptions::getBlobManagementOptions()는 BLOB 처리 및 임시 파일 사용에 대한 제어를 제공합니다. PHP via Java 대용량 파일 예제는 Open Presentations를 참고하십시오.

대용량 파일의 경우 가능한 파일 경로에서 로드하고, 병합이 완료되면 즉시 각 소스 프레젠테이션을 해제하며, 워크플로우가 체크포인트를 요구하지 않는 한 중간 결과를 반복적으로 저장하지 않도록 하십시오.

스레드 안전성

Presentation 인스턴스를 여러 스레드에서 로드, 수정, 저장 또는 복제하지 마십시오. 이러한 작업은 PHP via Java에서 멀티스레드 사용을 지원하지 않습니다. 병합 작업을 병렬로 수행해야 하면 별도의 단일 스레드 프로세스에서 각각 독립적인 프레젠테이션 인스턴스를 사용하고, Aspose.Slides 멀티스레딩 가이드를 따르십시오.

FAQ

각 소스 프레젠테이션의 원래 디자인을 유지하려면 어떻게 해야 하나요?

대상 마스터 또는 레이아웃을 지정하지 않고 SlideCollection::addClone을 사용하십시오. Aspose.Slides는 가져온 슬라이드에 필요할 경우 소스 마스터를 자동으로 복제할 수 있습니다.

가져온 슬라이드가 대상 테마를 사용하도록 하려면 어떻게 해야 하나요?

대상 마스터를 받아들이는 오버로드를 사용하십시오. 소스가 아닌 대상 프레젠테이션의 마스터를 전달하면 Aspose.Slides가 해당 마스터 아래에 적절한 레이아웃을 매핑하려 시도합니다.

대상 마스터 대신 특정 대상 레이아웃을 사용해야 하는 경우는 언제인가요?

모든 가져온 슬라이드가 하나의 알려진 레이아웃을 사용해야 할 때 특정 레이아웃을 사용합니다. 소스 레이아웃 유형이나 이름에 따라 마스터의 여러 레이아웃 중 하나를 선택하도록 하려면 마스터를 사용하십시오.

다른 슬라이드 크기를 가진 프레젠테이션을 병합할 수 있나요?

가능하지만 슬라이드 내용이 대상 차원에 맞게 자동으로 재설계되지는 않습니다. 예측 가능한 배치를 원한다면 SlideSize::setSize()와 SlideSizeScaleType::EnsureFit을 사용해 소스 프레젠테이션을 먼저 크기 조정하십시오.

PPT, PPTX 및 ODP 프레젠테이션을 하나의 파일로 병합할 수 있나요?

예. 각 소스 프레젠테이션을 로드한 뒤 필요한 슬라이드를 하나의 대상에 복제하고 지원되는 출력 형식으로 저장하십시오. 프레젠테이션 형식마다 지원 기능이 정확히 동일하지 않으므로, 교차 형식 병합 후 복잡한 콘텐츠를 검증하십시오. 자세한 내용은 Supported File Formats를 참조하십시오.

소스 섹션이 자동으로 보존되나요?

슬라이드만 복제하는 기본 루프에서는 자동으로 보존되지 않습니다. 섹션 구조가 필요하면 대상에 섹션을 재생성하고 addClone의 섹션 오버로드를 사용하십시오.

스피커 노트와 댓글이 보존되나요?

복제된 슬라이드와 함께 복사됩니다. 노트 마스터 스타일링, 댓글 작성자 또는 스레드형 리뷰 데이터에 의존하는 워크플로우에서는 병합 결과를 검증하십시오. 이러한 시나리오는 슬라이드 수준 콘텐츠뿐 아니라 프레젠테이션 수준 구조도 포함합니다.

오디오, 비디오, OLE 개체 및 하이퍼링크는 어떻게 처리되나요?

임베디드 콘텐츠는 복제된 슬라이드의 리소스 관계에 포함됩니다. 외부 링크는 여전히 외부에 남아 있으므로, 병합 후에도 해당 파일이나 URL이 사용 가능해야 합니다.

모든 소스에서 임베디드된 폰트가 병합된 프레젠테이션에서 사용할 수 있나요?

슬라이드 복제만으로 폰트 배포를 보장하지 마십시오. 대상의 임베디드 폰트를 검사하고, 타이포그래피가 중요한 경우 폰트 임베딩이나 외부 폰트 가용성을 명시적으로 관리하십시오.

비밀번호 보호된 파일을 어떻게 병합하나요?

LoadOptions::setPassword()를 사용해 올바른 비밀번호로 파일을 연 후 슬라이드를 정상적으로 복제하십시오. 출력 보호는 별도로 설정합니다.

대용량 프레젠테이션을 어떻게 처리해야 하나요?

BLOB 관리 옵션을 활용해 대용량 바이너리 객체를 효율적으로 처리하고, 가능한 경우 파일 경로에서 로드하며, 병합이 끝난 즉시 소스 프레젠테이션을 해제하고, 워크플로우가 체크포인트를 요구하지 않을 경우 중간 결과를 반복 저장하지 마십시오.

여러 스레드에서 슬라이드를 병합할 수 있나요?

PHP via Java에서는 프레젠테이션을 여러 스레드에서 로드, 저장 또는 복제하는 것을 지원하지 않습니다. 병렬 작업이 필요하면 별도의 단일 스레드 프로세스를 사용하고, 각 프로세스가 자체 프레젠테이션 인스턴스를 갖도록 하십시오.