Введение

Aspose.Slides FOSS for C++ is now available: a free, MIT-licensed library for creating, reading, and editing PowerPoint .pptx файлы на чистом C++, без зависимости от Microsoft Office или какого-либо проприетарного runtime.

Библиотека предназначена для разработчиков, которым необходимо программно генерировать или манипулировать файлами презентаций: автоматизировать наборы слайдов из данных, извлекать текст и метаданные из загруженных файлов PPTX, создавать конвейеры отчетности на основе презентаций или встраивать создание презентаций в настольные и серверные приложения. Потому что aspose_slides_foss создана с помощью CMake, она компилируется и разворачивается на Windows, macOS и Linux.

Ключевые возможности

  • Полная поддержка обратного цикла PPTX: Откройте любой .pptx файл, измените его содержимое и сохраните обратно, не теряя неизвестные XML‑части, которые библиотека пока не понимает.
  • Управление слайдами: Добавляйте, удаляйте и перебирайте слайды с помощью prs.slides(); презентация начинается с одного пустого слайда после создания Presentation.
  • AutoShapes, таблицы и соединители: Вставить фигуры через slide.shapes().add_auto_shape(), табличные данные через slide.shapes().add_table(), и визуальные соединители между фигурами через slide.shapes().add_connector().
  • Форматирование Rich text: Форматировать текст на уровне символов с помощью PortionFormat: размер шрифта, полужирный, курсив, подчеркивание и цвет ARGB через FillType::SOLID и ColorFormat.
  • Типы заливки: Применить FillType::SOLID, Gradient, Pattern, или Picture заполняет любую форму.
  • Визуальные эффекты: Внешняя тень, свечение, мягкий край, размытие, отражение и внутренняя тень через shape.effect_format().
  • 3D formatting: Фаска, камера, световая установка, материал и глубина выдавливания через shape.three_d_format().
  • Заметки докладчика: Прикрепить текст заметок к каждому слайду через notes_slide_manager().add_notes_slide().
  • Ветвящиеся комментарии: Добавлять комментарии с метаданными автора и позицией слайда.
  • Встроенные изображения: Встраивать из пути к файлу, буфера памяти или потока.
  • Свойства документа: Читать и записывать основные, приложенные и пользовательские свойства.

Начало работы

Добавьте библиотеку через CMake. Требуется компилятор C++17.

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)
target_link_libraries(your_target PRIVATE aspose_slides_foss)

Создайте свою первую презентацию с фигурой и сохраните её:

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

int main() {
    using namespace Aspose::Slides::Foss;

    Presentation prs;
    auto& slide = prs.slides()[0];
    auto& shape = slide.shapes().add_auto_shape(
        ShapeType::RECTANGLE, 50, 50, 400, 120
    );
    shape.text_frame()->set_text("Hello from Aspose.Slides FOSS!");
    prs.save("hello.pptx", SaveFormat::PPTX);
    return 0;
}

Этот Presentation деструктор автоматически освобождает все внутренние ресурсы, когда он выходит из области видимости.

Пример форматирования текста

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

using namespace Aspose::Slides::Foss;

Presentation prs;
auto& shape = prs.slides()[0].shapes().add_auto_shape(
    ShapeType::RECTANGLE, 50, 50, 500, 150
);
shape.text_frame()->set_text("Bold heading in corporate blue");
auto& fmt = shape.text_frame()->paragraphs()[0].portions()[0].portion_format();
fmt.set_font_height(28);
fmt.set_font_bold(NullableBool::TRUE);
fmt.fill_format().set_fill_type(FillType::SOLID);
fmt.fill_format().solid_fill_color().set_color(Color::from_argb(255, 0, 70, 127));
prs.save("formatted.pptx", SaveFormat::PPTX);

Текущие ограничения

В следующих областях в этой версии генерируются исключения:

  • Диаграммы, SmartArt и OLE‑объекты
  • Анимации и переходы слайдов
  • Экспорт в PDF, HTML, SVG или форматы изображений
  • Гиперссылки, настройки действий, макросы VBA и цифровые подписи

Неизвестные XML‑части, обнаруженные при загрузке, сохраняются дословно при сохранении, поэтому PPTX‑файлы, созданные другими инструментами, безопасно проходят цикл загрузки‑сохранения.

См. также