Úvod

Aspose.Slides FOSS for Java is now available on Maven Central: a free, MIT-licensed library for creating, reading, and editing PowerPoint .pptx súbory úplne v Java, bez závislosti na Microsoft Office ani na žiadnom proprietárnom runtime.

Knižnica je určená pre vývojárov, ktorí potrebujú programovo generovať alebo manipulovať s prezentačnými súbormi: automatizovať sady snímok z dát, extrahovať text a metadáta z nahratých PPTX súborov, budovať reportovacie pipeline založené na prezentáciách alebo vkladať tvorbu prezentácií do aplikácií Spring Boot. Preto aspose-slides-foss je čistý Java, nasadzuje sa rovnako na Windows, macOS, Linux a Docker kontajnery.

Kľúčové funkcie

  • Kompletná podpora round-trip PPTX: Otvoriť akýkoľvek .pptx súbor, upraviť jeho obsah a uložiť ho späť bez straty neznámych XML častí, ktoré knižnica ešte nepozná.
  • Správa snímok: Pridať, odstrániť a prechádzať snímky pomocou prs.getSlides(); prezentácia začína jednou prázdnou snímkou po new Presentation().
  • AutoShapes, Tabuľky a Konektory: Vložiť tvary cez slide.getShapes().addAutoShape(), tabuľkové dáta cez slide.getShapes().addTable(), a vizuálne konektory medzi tvarmi cez slide.getShapes().addConnector().
  • Formátovanie bohatého textu: Formátovať text na úrovni znaku pomocou PortionFormat: veľkosť písma, tučné, kurzíva, podčiarknutie a ARGB farbu cez FillType.SOLID a ColorFormat.
  • Typy výplne: Použiť FillType.SOLID, GRADIENT, PATTERN, alebo PICTURE vyplní do akéhokoľvek tvaru.
  • Vizuálne efekty: Vonkajší tieň, žiara, mäkký okraj, rozostrenie, odraz a vnútorný tieň cez shape.getEffectFormat().
  • 3D formatting: Skosenie, kamera, osvetľovacia súprava, materiál a hĺbka extrúzie cez shape.getThreeDFormat().
  • Poznámky prednášajúceho: Pripojte text poznámok k jednotlivým snímkam cez getNotesSlideManager().addNotesSlide().
  • Vlákna komentárov: Pridajte komentáre s metadátami autora a pozíciou snímky.
  • Vložené obrázky: Vložte z cesty k súboru, bajtov alebo InputStream.
  • Vlastnosti dokumentu: Čítajte a zapisujte základné, aplikačné a vlastné vlastnosti.

Začíname

Pridajte Maven závislosť. Java 21 alebo novší je vyžadovaný.

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

Vytvorte svoju prvú prezentáciu s tvarom a uložte ju:

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");
        }
    }
}

Vždy používajte Presentation vo vnútri bloku try-with-resources; to zabezpečuje, že všetky interné zdroje sú uvoľnené pri ukončení bloku.

Príklad formátovania textu

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");
}

Aktuálne obmedzenia

Nasledujúce oblasti vyhadzujú UnsupportedOperationException v tomto vydaní:

  • Grafy, SmartArt a OLE objekty
  • Animácie a prechody snímok
  • Export do PDF, HTML, SVG alebo obrazových formátov
  • Hyperlinky, nastavenia akcií, VBA makrá a digitálne podpisy

Neznáme XML časti, ktoré sa objavia počas načítania, sa pri ukladaní zachovajú doslovne, takže PPTX súbory vytvorené inými nástrojmi prechádzajú bezpečným round‑tripom.

Pozri tiež