1. Produtos
  2.   Aspose.Slides
  3.   Aspose.Slides FOSS for Python

Aspose.Slides FOSS para Python

Crie, leia e edite apresentações PowerPoint a partir de Python — gratuito e de código aberto, sem dependência do Office.

Aspose.Slides FOSS for Python Aspose.Slides FOSS
for Python

Documentação GitHub

Biblioteca Python de código aberto para apresentações PowerPoint

Aspose.Slides FOSS para Python é uma biblioteca pure-Python licenciada sob MIT para trabalhar com arquivos PowerPoint .pptx. Instale-a com um único comando pip e comece imediatamente a criar, ler e editar apresentações sem instalar o Microsoft Office ou qualquer runtime proprietário.

A biblioteca expõe uma API de Apresentação construída em torno de Presentation, Slide, Shape, TextFrame, Paragraph e Portion, o modelo conceitual usado pelo próprio PowerPoint. Adicione e remova slides, insira AutoShapes, Tabelas e Conectores, formate texto ao nível de caractere com negrito, itálico, tamanho e cor da fonte, aplique preenchimentos sólidos ou em gradiente e adicione efeitos visuais (sombra, brilho, desfoque, reflexão).

O padrão de gerenciador de contexto garante a limpeza confiável de recursos: sempre abra uma Presentation com with slides.Presentation(...) as prs:. Partes XML desconhecidas encontradas durante o carregamento são preservadas literalmente ao salvar, de modo que a ida e volta nunca destrói conteúdo que a biblioteca ainda não entende. A biblioteca requer Python 3.10 ou superior e depende apenas de lxml, instalado automaticamente.

API de apresentação e slide

  • Criar e abrir PPTX: Crie novas apresentações ou abra arquivos .pptx existentes.
  • Adicionar e remover slides: Gerencie a coleção de slides programaticamente.
  • AutoShapes: Insira retângulos, elipses, linhas e outros tipos de AutoShape.
  • Tabelas e Conectores: Adicione formas de tabela estruturadas e linhas de conexão entre formas.
  • Anotações do apresentador: Leia e escreva anotações do apresentador por slide.
  • Comentários em tópicos: Acesse os threads de comentários ao nível do slide.

Onde Aspose.Slides FOSS pode ser usado

  • Geração de relatórios: Crie decks de slides com marca a partir de fontes de dados sem o Office.
  • Automação de templates: Preencha templates PPTX com conteúdo dinâmico em pipelines CI/CD.
  • Migração de conteúdo: Leia apresentações existentes e reestruture ou reformate os slides.
  • Back‑ends sem servidor: Processar arquivos PPTX dentro de contêineres Docker ou funções Lambda.
  • Processamento em lote: Aplicar alterações de formatação uniformes em grandes bibliotecas de decks de slides.

Formatação de texto e efeitos visuais

  • Formatação ao nível de caractere: Aplique negrito, itálico, tamanho de fonte e cor a objetos Portion individuais.
  • Preenchimentos sólido e gradiente: Defina o preenchimento da forma como uma cor sólida ou gradiente linear com múltiplas paradas.
  • Efeitos de sombra e brilho: Aplique sombra externa, brilho, desfoque e reflexão a qualquer forma.
  • Alinhamento de parágrafo: Defina alinhamento à esquerda, centralizado, à direita ou justificado por parágrafo.
  • Segurança em ida e volta: Partes XML desconhecidas são preservadas literalmente ao salvar novamente.

Experiência do desenvolvedor

Aspose.Slides FOSS instala com um único comando pip install aspose-slides-foss. A única dependência em tempo de execução é lxml, instalada automaticamente. Não há extensões nativas para compilar.

A API espelha o próprio modelo de objetos do PowerPoint (Presentation, Slide, Shape, TextFrame, Paragraph, Portion), portanto quem está familiarizado com o modelo de objetos do PowerPoint pode usar a biblioteca imediatamente. É licenciada sob MIT, código aberto no GitHub, e requer Python 3.10 ou superior.

Criar uma Apresentação e Adicionar uma Forma

Use o gerenciador de contexto (with slides.Presentation() as prs:) para garantir que o PPTX seja sempre fechado e os recursos sejam liberados. add_auto_shape() recebe um enum ShapeType, depois a posição x/y e a largura/altura em pontos — a propriedade text_frame.text da forma define o rótulo em uma única linha.

pip install aspose-slides-foss

import aspose.slides_foss as slides

with slides.Presentation() as prs:
    slide = prs.slides[0]

    # Adicionar um AutoShape retangular
    shape = slide.shapes.add_auto_shape(
        slides.ShapeType.RECTANGLE, 50, 50, 400, 150
    )
    shape.text_frame.text = "Hello, Aspose.Slides!"

    prs.save("output.pptx", slides.export.SaveFormat.PPTX)

Formatar Texto e Aplicar um Efeito de Preenchimento

A formatação de texto funciona no nível de Portion — a menor unidade de uma sequência de caracteres. Abra o arquivo salvo, navegue até a primeira porção do primeiro parágrafo e defina as propriedades da fonte diretamente. O preenchimento da forma é independente: defina fill_type como SOLID e atribua uma cor a solid_fill_color.color.

import aspose.slides_foss as slides
from aspose.slides_foss.drawing import Color

with slides.Presentation("output.pptx") as prs:
    shape = prs.slides[0].shapes[0]
    portion = shape.text_frame.paragraphs[0].portions[0]

    # Negrito, 18pt, texto azul-escuro
    portion.portion_format.font_bold = True
    portion.portion_format.font_height = 18
    portion.portion_format.fill_format.solid_fill_color.color = Color.dark_blue

    # Preenchimento de fundo sólido na forma
    shape.fill_format.fill_type = slides.FillType.SOLID
    shape.fill_format.solid_fill_color.color = Color.alice_blue

    prs.save("formatted.pptx", slides.export.SaveFormat.PPTX)

Perguntas Frequentes

O que é Aspose.Slides FOSS para Python?

É uma biblioteca gratuita, licenciada sob MIT, pure-Python para criar, ler e editar apresentações PowerPoint .pptx sem exigir o Microsoft Office.

Quais formatos de arquivo são suportados?

PPTX é o formato de leitura/gravação suportado. Exportar para PDF, HTML, SVG ou imagens não está disponível nesta edição.

Ele requer Microsoft Office ou PowerPoint?

Não. Aspose.Slides FOSS é uma biblioteca pure-Python sem dependência do Microsoft Office, automação COM ou qualquer runtime proprietário.

Como instalá-lo?

Execute pip install aspose-slides-foss. A única dependência é lxml, instalada automaticamente. Python 3.10 ou posterior é necessário.

Posso aplicar efeitos visuais como sombra e brilho?

Sim. A biblioteca suporta efeitos de sombra externa, brilho, desfoque e reflexão em qualquer objeto de forma.

O padrão de gerenciador de contexto é recomendado?

Sim. Sempre abra uma Presentation com with slides.Presentation(...) as prs: para garantir a limpeza confiável de recursos.

O round-tripping de um PPTX destruirá conteúdo desconhecido?

Não. Partes XML desconhecidas encontradas durante o carregamento são preservadas literalmente ao salvar, de modo que o conteúdo que a biblioteca ainda não entende nunca é perdido.

Onde posso encontrar o código-fonte?

A biblioteca tem licença MIT e está hospedada no GitHub. Relatórios de bugs e pull requests são bem‑vindos.

  

Recursos de Suporte e Aprendizado

 Português