Aspose.Slides FOSS
C++
C++에서 프레젠테이션 로드하는 방법

C++에서 프레젠테이션 로드하는 방법

Aspose.Slides FOSS for C++ lets you open any .pptx 파일을 검사하고 내용을 확인한 뒤 PPTX로 다시 저장하거나 데이터를 추출합니다. 이 가이드는 파일 열기, 슬라이드 순회, 도형 텍스트 읽기, 그리고 저장을 라운드 트립하는 방법을 다룹니다.

단계별 가이드

단계 1: 라이브러리 빌드 및 링크 

git clone https://github.com/aspose-slides-foss/Aspose.Slides-FOSS-for-Cpp.git
cd Aspose.Slides-FOSS-for-Cpp && mkdir build && cd build
cmake .. && cmake --build .

단계 2: 기존 프레젠테이션 열기

파일 경로를 다음에 전달합니다 Presentation 생성자. 소멸자는 정리를 처리합니다.

#include <Aspose/Slides/Foss/presentation.h>
#include <iostream>

int main() {
    namespace asf = Aspose::Slides::Foss;

    asf::Presentation prs("input.pptx");
    std::cout << "Slide count: " << prs.slides().size() << "\n";
    prs.save("output.pptx", asf::SaveFormat::PPTX);
    return 0;
}

소스 파일의 알 수 없는 XML 파트는 그대로 보존됩니다: 라이브러리는 아직 이해하지 못하는 내용을 절대 제거하지 않습니다.

단계 3: 슬라이드 검사

모든 슬라이드를 순회하며 각 슬라이드의 도형 개수를 출력합니다:

#include <Aspose/Slides/Foss/presentation.h>
#include <iostream>

int main() {
    namespace asf = Aspose::Slides::Foss;

    asf::Presentation prs("deck.pptx");
    for (size_t i = 0; i < prs.slides().size(); ++i) {
        auto& slide = prs.slides()[i];
        std::cout << "Slide " << i << ": "
                  << slide.shapes().size() << " shapes\n";
    }
    return 0;
}

단계 4: 도형 텍스트 읽기

도형을 순회하고 텍스트가 있는 도형에서 텍스트를 읽습니다. TextFrame:

#include <Aspose/Slides/Foss/presentation.h>
#include <iostream>

int main() {
    namespace asf = Aspose::Slides::Foss;

    asf::Presentation prs("deck.pptx");
    for (size_t i = 0; i < prs.slides().size(); ++i) {
        auto& slide = prs.slides()[i];
        for (size_t j = 0; j < slide.shapes().size(); ++j) {
            auto& shape = slide.shapes()[j];
            if (shape.has_text_frame()) {
                auto text = shape.text_frame()->text();
                if (!text.empty()) {
                    std::cout << "  Shape text: " << text << "\n";
                }
            }
        }
    }
    return 0;
}

단계 5: 문서 속성 읽기

다음에서 핵심 문서 속성에 접근합니다 prs.document_properties():

#include <Aspose/Slides/Foss/presentation.h>
#include <iostream>

int main() {
    namespace asf = Aspose::Slides::Foss;

    asf::Presentation prs("deck.pptx");
    auto& props = prs.document_properties();
    std::cout << "Title:   " << props.title() << "\n";
    std::cout << "Author:  " << props.author() << "\n";
    std::cout << "Subject: " << props.subject() << "\n";
    return 0;
}

단계 6: 라운드 트립 저장

프레젠테이션을 검사하거나 수정한 후, PPTX로 다시 저장합니다:

prs.save("output.pptx", asf::SaveFormat::PPTX);

다른 경로에 저장하면 새 파일이 생성됩니다. 같은 경로에 저장하면 원본이 덮어쓰기됩니다.

일반적인 문제 및 해결책

파일을 찾을 수 없거나 열 수 없습니다

다​음에 대한 경로가 올바른지 확인합니다 .pptx 파일이 작업 디렉터리를 기준으로 올바른지 확인합니다. Use std::filesystem::path 강력한 경로 구성을 위해:

#include <filesystem>
auto path = std::filesystem::path(__FILE__).parent_path() / "assets" / "deck.pptx";
asf::Presentation prs(path.string());

예외: 파일 형식이 지원되지 않습니다

라이브러리는 지원합니다 .pptx (Office Open XML)만 지원합니다. 레거시 .ppt (binary PowerPoint 97-2003) 파일은 지원되지 않습니다.

Shape에 text_frame이 없습니다

일부 도형(Connectors, PictureFrames, GroupShapes)에는 텍스트 프레임이 없습니다. Guard with shape.has_text_frame() 텍스트에 접근하기 전에.

자주 묻는 질문

로드 시 원본 콘텐츠가 모두 보존됩니까?

예. 알 수 없는 XML 파트는 라운드 트립 저장 시 그대로 보존됩니다. 라이브러리는 이해하는 문서 모델의 파트만 직렬화하고, 인식하지 못하는 XML은 그대로 전달합니다.

암호로 보호된 PPTX를 로드할 수 있나요?

암호로 보호된(암호화된) 프레젠테이션은 이 버전에서 지원되지 않습니다.

내장된 이미지를 추출할 수 있나요?

이미지 컬렉션에 접근합니다: prs.images() 다음을 반환합니다 ImageCollection. 각 이미지에는 a width(), height(), 그리고 binary_data() 원시 이미지 데이터를 읽는 방법.

메모리 버퍼에서 로드하는 것이 지원되나요?

에서 로드 중 std::vector<uint8_t> 또는 std::istream 현재 API에서는 노출되지 않습니다. 바이트를 먼저 임시 파일에 기록한 다음, 해당 경로를 Presentation 생성자에 전달하십시오.

또 보기

 한국어