Úvod

Aspose.Slides FOSS for Java is now available on Maven Central: a free, MIT-licensed library for creating, reading, and editing PowerPoint .pptx soubory zcela v Java, bez závislosti na Microsoft Office ani na žádném proprietárním runtime.

Knihovna je navržena pro vývojáře, kteří potřebují programově generovat nebo manipulovat s prezentačními soubory: automatizovat sady snímků z dat, extrahovat text a metadata z nahraných souborů PPTX, vytvářet reportovací pipeline založené na prezentacích nebo vkládat tvorbu prezentací do aplikací Spring Boot. Protože aspose-slides-foss je čistý Java, nasazuje se identicky na Windows, macOS, Linux a Docker kontejnerech.

Klíčové vlastnosti

  • Plná podpora round-trip PPTX: Otevřete libovolný .pptx soubor, upravte jeho obsah a uložte jej zpět, aniž byste ztratili neznámé XML části, které knihovna zatím nezná.
  • Správa snímků: Přidávejte, odstraňujte a procházejte snímky pomocí prs.getSlides(); prezentace začíná jedním prázdným snímkem po new Presentation().
  • AutoShapes, Tabulky a Spojnice: Vkládejte tvary pomocí slide.getShapes().addAutoShape(), tabulková data pomocí slide.getShapes().addTable(), a vizuální spoje mezi tvary pomocí slide.getShapes().addConnector().
  • Formátování bohatého textu: Formátujte text na úrovni znaků pomocí PortionFormat: velikost písma, tučné, kurzíva, podtržení a ARGB barvu pomocí FillType.SOLID a ColorFormat.
  • Typy výplně: Použít FillType.SOLID, GRADIENT, PATTERN, nebo PICTURE vyplní do libovolného tvaru.
  • Vizuální efekty: Vnější stín, záře, měkký okraj, rozostření, odraz a vnitřní stín pomocí shape.getEffectFormat().
  • 3D formatting: Zkosení, kamera, světelný aparát, materiál a hloubka extruze pomocí shape.getThreeDFormat().
  • Poznámky přednášejícího: Připojte text poznámek k jednotlivým snímkům pomocí getNotesSlideManager().addNotesSlide().
  • Vlákna komentářů: Přidejte komentáře s metadaty autora a pozicí snímku.
  • Vložené obrázky: Vložte z cesty k souboru, bajtů nebo InputStream.
  • Vlastnosti dokumentu: Čtěte a zapisujte základní, aplikační a vlastní vlastnosti.

Začínáme

Přidejte Maven závislost. Java 21 nebo novější je vyžadován.

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

Vytvořte svou první prezentaci s tvarem a uložte ji:

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žívejte Presentation uvnitř bloku try-with-resources; to zajišťuje uvolnění všech vnitřních zdrojů při ukončení bloku.

Příklad formátování 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ální omezení

Následující oblasti vyvolávají UnsupportedOperationException v tomto vydání:

  • Grafy, SmartArt a OLE objekty
  • Animace a přechody snímků
  • Export do formátů PDF, HTML, SVG nebo obrázků
  • Hyperlinky, nastavení akcí, VBA makra a digitální podpisy

Neznámé XML části, které byly během načítání zaznamenány, jsou při ukládání zachovány beze změny, takže PPTX soubory vytvořené jinými nástroji bezpečně projdou zpětným načtením.

Viz také