Вступ

Aspose.Slides FOSS for Java is now available on Maven Central: a free, MIT-licensed library for creating, reading, and editing PowerPoint .pptx файли повністю у Java, без залежності від Microsoft Office чи будь-якого пропрієтарного середовища виконання.

Бібліотека розроблена для розробників, яким потрібно програмно генерувати або маніпулювати файлами презентацій: автоматизувати створення наборів слайдів з даних, витягувати текст і метадані з завантажених PPTX‑файлів, будувати конвеєри звітності на основі презентацій або вбудовувати створення презентацій у застосунки Spring Boot. Оскільки aspose-slides-foss є чистим Java, його розгортання однакове на Windows, macOS, Linux та в Docker‑контейнерах.

Ключові можливості

  • Повна підтримка двосторонньої роботи з PPTX: Відкрити будь‑який .pptx файл, змінити його вміст і зберегти назад без втрати невідомих XML‑частин, які бібліотека ще не розуміє.
  • Керування слайдами: Додавати, видаляти та перебирати слайди за допомогою prs.getSlides(); презентація починається з одного порожнього слайду після new Presentation().
  • AutoShapes, таблиці та з’єднувачі: Вставити фігури за допомогою slide.getShapes().addAutoShape(), табличні дані за допомогою slide.getShapes().addTable(), та візуальні з’єднувачі між фігурами за допомогою slide.getShapes().addConnector().
  • Форматування багатого тексту: Форматувати текст на рівні символів за допомогою PortionFormat: розмір шрифту, жирний, курсив, підкреслення та колір ARGB за допомогою FillType.SOLID і ColorFormat.
  • Типи заповнення: Застосувати FillType.SOLID, GRADIENT, PATTERN, або PICTURE fills будь‑якої форми.
  • Візуальні ефекти: Outer shadow, glow, soft edge, blur, reflection, та inner shadow за допомогою shape.getEffectFormat().
  • 3D formatting: Bevel, camera, light rig, material, та extrusion depth за допомогою shape.getThreeDFormat().
  • Нотатки доповідача: Прикріпити текст нотаток до кожного слайду через getNotesSlideManager().addNotesSlide().
  • Коментарі у вигляді гілок: Додати коментарі з метаданими автора та позицією слайду.
  • Вбудовані зображення: Вбудувати з шляху файлу, байтів або InputStream.
  • Властивості документа: Читати та записувати основні, додаткові та користувацькі властивості.

Getting Started

Додайте залежність Maven. Потрібен Java 21 або новіший.

<dependency>
    <groupId>org.aspose.slides.foss</groupId>
    <artifactId>aspose-slides-foss</artifactId>
    <version>1.0.0</version>
</dependency>

Створіть свою першу презентацію з формою та збережіть її:

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ISlide;
import org.aspose.slides.foss.IAutoShape;
import org.aspose.slides.foss.ITextFrame;
import org.aspose.slides.foss.IPortionFormat;
import org.aspose.slides.foss.ShapeType;
import org.aspose.slides.foss.FillType;
import org.aspose.slides.foss.NullableBool;
import org.aspose.slides.foss.export.SaveFormat;
import org.aspose.slides.foss.drawing.Color;

public class HelloSlides {
    public static void main(String[] args) {
        try (Presentation prs = new Presentation()) {
            ISlide slide = prs.getSlides().get(0);
            IAutoShape shape = slide.getShapes().addAutoShape(
                ShapeType.RECTANGLE, 50, 50, 400, 120
            );
            shape.addTextFrame("Hello from Aspose.Slides FOSS!");
            prs.save("hello.pptx");
        }
    }
}

Завжди використовуйте Presentation всередині блоку try-with-resources; це забезпечує звільнення всіх внутрішніх ресурсів при виході з блоку.

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

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ISlide;
import org.aspose.slides.foss.IAutoShape;
import org.aspose.slides.foss.ITextFrame;
import org.aspose.slides.foss.IPortionFormat;
import org.aspose.slides.foss.ShapeType;
import org.aspose.slides.foss.FillType;
import org.aspose.slides.foss.NullableBool;
import org.aspose.slides.foss.export.SaveFormat;
import org.aspose.slides.foss.drawing.Color;

try (Presentation prs = new Presentation()) {
    IAutoShape shape = prs.getSlides().get(0).getShapes().addAutoShape(
        ShapeType.RECTANGLE, 50, 50, 500, 150
    );
    ITextFrame tf = shape.addTextFrame("Bold heading in corporate blue");
    IPortionFormat fmt = tf.getParagraphs().get(0).getPortions().get(0).getPortionFormat();
    fmt.setFontHeight(28);
    fmt.setFontBold(NullableBool.TRUE);
    fmt.getFillFormat().setFillType(FillType.SOLID);
    fmt.getFillFormat().getSolidFillColor().setColor(new Color(0, 70, 127));
    prs.save("formatted.pptx");
}

Поточні обмеження

Наступні ділянки викидають UnsupportedOperationException у цьому випуску:

  • Діаграми, SmartArt та OLE‑об’єкти
  • Анімації та переходи між слайдами
  • Експорт у PDF, HTML, SVG або формати зображень
  • Гіперпосилання, налаштування дій, VBA‑макроси та цифрові підписи

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

Див. також