Aspose.Slides FOSS
C++
C++에서 프레젠테이션 만들기

C++에서 프레젠테이션 만들기

Aspose.Slides FOSS for C++는 Microsoft Office에 대한 의존 없이 C++만으로 PowerPoint 프레젠테이션을 완전히 만들 수 있게 해줍니다. 이 가이드는 새 프레젠테이션을 만들고, 슬라이드와 도형을 추가하고, 텍스트를 서식 지정하고, 결과를 저장하는 방법을 보여줍니다.

단계별 가이드

1단계: CMake 프로젝트에 라이브러리 추가

CMake FetchContent를 사용하여 라이브러리를 GitHub에서 직접 통합하십시오. C++20 이상이 필요합니다.

cmake_minimum_required(VERSION 3.20)
project(my_slides_app LANGUAGES CXX)
set(CMAKE_CXX_STANDARD 20)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

include(FetchContent)
FetchContent_Declare(
    aspose_slides_foss
    GIT_REPOSITORY https://github.com/aspose-slides-foss/Aspose.Slides-FOSS-for-Cpp.git
    GIT_TAG main
)
FetchContent_MakeAvailable(aspose_slides_foss)

add_executable(my_app main.cpp)
target_link_libraries(my_app PRIVATE aspose_slides_foss)

다른 시스템 패키지는 필요하지 않습니다.

2단계: 필요한 헤더 포함 

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

모든 타입은 Aspose::Slides::Foss 네임스페이스에 존재합니다. 간결성을 위해 아래 예제에서는 네임스페이스 별칭을 사용합니다:

namespace asf = Aspose::Slides::Foss;

3단계: 프레젠테이션 만들기

스택에 Presentation을 구성하십시오. 새 프레젠테이션은 빈 슬라이드 하나로 시작합니다.

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

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

    asf::Presentation prs;
    std::cout << "Slides in new presentation: " << prs.slides().size() << "\n";
    prs.save("output.pptx", asf::SaveFormat::PPTX);
    return 0;
}

중요: 스택 할당 또는 std::unique_ptr를 사용하여 소멸자가 내부 리소스를 자동으로 해제하도록 하세요.

4단계: 슬라이드에 액세스

첫 번째 슬라이드는 인덱스 0에 있습니다. 빈 프레젠테이션에는 정확히 한 개의 슬라이드가 있습니다.

namespace asf = Aspose::Slides::Foss;

asf::Presentation prs;
auto& slide = prs.slides()[0]; // zero-based index
prs.save("output.pptx", asf::SaveFormat::PPTX);

5단계: 도형 추가

slide.shapes().add_auto_shape()를 사용하여 AutoShape을 추가합니다. 매개변수는 (shape_type, x, y, width, height)이며 모두 포인트 단위입니다 (1 포인트 = 1/72 인치; 표준 슬라이드는 720 x 540 pt).

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

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

    asf::Presentation prs;
    auto& slide = prs.slides()[0];

    // Rectangle at (50, 50) with 400 wide and 120 tall
    auto& shape = slide.shapes().add_auto_shape(
        asf::ShapeType::RECTANGLE, 50, 50, 400, 120);

    // Set text on the shape's text frame
    shape.text_frame()->set_text("Hello from Aspose.Slides FOSS!");

    prs.save("with-shape.pptx", asf::SaveFormat::PPTX);
    return 0;
}

Step 6: 프레젠테이션 저장

prs.save(path, SaveFormat::PPTX)을 Presentation이 범위를 벗어나기 전에 호출하십시오. PPTX는 지원되는 유일한 출력 형식입니다.

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

파일은 원자적으로 기록됩니다; 이 호출 전에 오류가 발생하면 출력 파일이 생성되지 않습니다.

완전한 작업 예제

다음 프로그램은 첫 번째 슬라이드에 제목 도형이 있고 두 번째 슬라이드에 표가 있는 두 슬라이드 프레젠테이션을 생성합니다.

#include <Aspose/Slides/Foss/presentation.h>
#include <vector>
#include <string>

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

    asf::Presentation prs;

    // --- Slide 1: title shape ---
    auto& slide1 = prs.slides()[0];
    auto& title = slide1.shapes().add_auto_shape(
        asf::ShapeType::RECTANGLE, 40, 40, 640, 80);
    title.text_frame()->set_text("Q1 Results: Executive Summary");
    auto& fmt = title.text_frame()->paragraphs()[0].portions()[0].portion_format();
    fmt.set_font_height(32);
    fmt.set_font_bold(asf::NullableBool::TRUE);
    fmt.fill_format().set_fill_type(asf::FillType::SOLID);
    fmt.fill_format().solid_fill_color().set_color(
        asf::Color::from_argb(255, 0, 70, 127));

    // --- Slide 2: table ---
    prs.slides().add_empty_slide(&prs.layout_slides()[0]);
    auto& slide2 = prs.slides()[1];
    std::vector<double> col_w = {200.0, 120.0, 120.0};
    std::vector<double> row_h = {40.0, 40.0, 40.0};
    auto& table = slide2.shapes().add_table(40, 40, col_w, row_h);

    std::vector<std::string> headers = {"Region", "Revenue", "Growth"};
    std::vector<std::vector<std::string>> data = {
        {"North", "$1.2M", "+8%"},
        {"South", "$0.9M", "+4%"},
    };
    for (size_t col = 0; col < headers.size(); ++col) {
        table.rows()[0][col].text_frame()->set_text(headers[col]);
    }
    for (size_t r = 0; r < data.size(); ++r) {
        for (size_t c = 0; c < data[r].size(); ++c) {
            table.rows()[r + 1][c].text_frame()->set_text(data[r][c]);
        }
    }

    prs.save("q1-results.pptx", asf::SaveFormat::PPTX);
    return 0;
}

일반적인 문제 및 해결책

Presentation 파괴 시 세그폴트 또는 이중 해제

Presentation이(가) 파괴된 후 슬라이드나 도형에 대한 참조 또는 포인터를 저장하고 있습니다. slides(), shapes() 등에서 반환되는 모든 참조는 Presentation 소멸자가 실행될 때 무효화됩니다. Presentation를 해당 자식 객체를 사용하는 전체 기간 동안 살아 있게 유지하십시오.

SaveFormat::PPTX is not a function 컴파일러 오류

SaveFormat::PPTX은 열거형 값이며 함수가 아닙니다. prs.save("file.pptx", asf::SaveFormat::PPTX)으로 사용하십시오.

링커 오류: Aspose::Slides::Foss::Presentation에 대한 정의되지 않은 참조

귀하의 CMakeLists.txt가 target_link_libraries(my_app PRIVATE aspose_slides_foss)와 함께 라이브러리에 링크되도록 하세요.

자주 묻는 질문

기본 슬라이드 크기는 무엇인가요?

새로운 Presentation()은 표준 10 x 7.5인치(720 x 540 포인트) 크기의 슬라이드를 생성합니다. 이 버전에서는 슬라이드 크기 변경을 아직 지원하지 않습니다.

한 번에 여러 슬라이드를 추가할 수 있나요?

예. prs.slides().add_empty_slide(&prs.layout_slides()[0])를 호출하여 빈 슬라이드를 추가하고 인덱스로 접근하십시오:

prs.slides().add_empty_slide(&prs.layout_slides()[0]);
auto& slide2 = prs.slides()[1];

기존 파일을 열고 슬라이드를 추가할 수 있나요?

예:

asf::Presentation prs("existing.pptx");
prs.slides().add_empty_slide(&prs.layout_slides()[0]);
prs.save("existing.pptx", asf::SaveFormat::PPTX);

어떤 형식으로 저장할 수 있나요?

SaveFormat::PPTX만 지원됩니다. PDF, HTML, SVG 또는 이미지로 내보내기는 이 버전에서 사용할 수 없습니다.

참조

 한국어