Introdução

Aspose.Slides FOSS for Java is now available on Maven Central: a free, MIT-licensed library for creating, reading, and editing PowerPoint .pptx arquivos totalmente em Java, sem dependência do Microsoft Office ou de qualquer runtime proprietário.

A biblioteca foi projetada para desenvolvedores que precisam gerar ou manipular arquivos de apresentação programaticamente: automatizar decks de slides a partir de dados, extrair texto e metadados de arquivos PPTX enviados, construir pipelines de relatórios baseados em apresentações ou incorporar a criação de apresentações em aplicações Spring Boot. Porque aspose-slides-foss é puro Java, ele é implantado de forma idêntica no Windows, macOS, Linux e contêineres Docker.

Recursos Principais

  • Suporte completo de ida e volta para PPTX: Abra qualquer .pptx arquivo, modifique seu conteúdo e salve-o novamente sem perder partes XML desconhecidas que a biblioteca ainda não entende.
  • Gerenciamento de slides: Adicione, remova e itere slides usando prs.getSlides(); a apresentação começa com um slide em branco após new Presentation().
  • AutoShapes, Tabelas e Conectores: Insira formas via slide.getShapes().addAutoShape(), dados tabulares via slide.getShapes().addTable(), e conectores visuais entre formas via slide.getShapes().addConnector().
  • Formatação de texto rico: Formate texto ao nível de caractere com PortionFormat: tamanho da fonte, negrito, itálico, sublinhado e cor ARGB via FillType.SOLID e ColorFormat.
  • Tipos de preenchimento: Aplique FillType.SOLID, GRADIENT, PATTERN, ou PICTURE preenchimentos a qualquer forma.
  • Efeitos visuais: Sombra externa, brilho, borda suave, desfoque, reflexão e sombra interna via shape.getEffectFormat().
  • 3D formatting: Bisel, câmera, rig de luz, material e profundidade de extrusão via shape.getThreeDFormat().
  • Notas do apresentador: Anexar texto de notas a cada slide via getNotesSlideManager().addNotesSlide().
  • Comentários em thread: Adicionar comentários com metadados do autor e posição do slide.
  • Imagens incorporadas: Incorporar a partir de caminho de arquivo, bytes ou InputStream.
  • Propriedades do documento: Ler e gravar propriedades core, app e personalizadas.

Começando

Adicione a dependência Maven. Java 21 ou posterior é necessário.

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

Crie sua primeira apresentação com uma forma e salve-a:

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

Sempre usar Presentation dentro de um bloco try-with-resources; isso garante que todos os recursos internos sejam liberados quando o bloco for encerrado.

Exemplo de Formatação de Texto

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

Limitações Atuais

As áreas a seguir lançam UnsupportedOperationException nesta versão:

  • Gráficos, SmartArt e objetos OLE
  • Animações e transições de slides
  • Exportar para PDF, HTML, SVG ou formatos de imagem
  • Hyperlinks, configurações de ação, macros VBA e assinaturas digitais

Partes XML desconhecidas encontradas durante o carregamento são preservadas literalmente ao salvar, de modo que arquivos PPTX produzidos por outras ferramentas façam round‑trip com segurança.

Veja Também