Como começar com Aspose.Slides FOSS para Python

aspose-slides-foss Python é uma biblioteca livre, licenciada pelo MIT para criar e editar. PowerPoint .pptx arquivos não é necessário Microsoft Office, Python puro de PyPI.

Guia passo a passo

Passo 1: Instalar o pacote

Instalar a partir do PyPI com pip:

pip install aspose-slides-foss>=26.3.2

Verifique se a instalação está correctamente carregada:

from aspose.slides_foss import Presentation
print("aspose-slides-foss is ready.")

Passo 2: Importar as classes necessárias

Importar os módulos que você precisa para carregar apresentações e salvar:

from aspose.slides_foss import Presentation, SaveFormat, ShapeType, FillType

Passo 3: Faça uma apresentação

Construir um Presentation sem argumentos para começar com um slide em branco:

from aspose.slides_foss import Presentation, SaveFormat

prs = Presentation()
slide = prs.slides[0]
print(f"Slides: {len(prs.slides)}")
prs.save("new_presentation.pptx", SaveFormat.PPTX)

Passo 4: Adicionar um formato com texto

Utilização: slide.shapes.add_auto_shape() para inserir um retângulo, em seguida, chamar add_text_frame() para adicionar conteúdo de texto:

from aspose.slides_foss import Presentation, SaveFormat, ShapeType

prs = Presentation()
slide = prs.slides[0]
shape = slide.shapes.add_auto_shape(ShapeType.RECTANGLE, 50, 50, 400, 150)
tf = shape.add_text_frame("Hello from Aspose.Slides FOSS!")
tf.paragraphs[0].portions[0].portion_format.font_height = 24
prs.save("with_shape.pptx", SaveFormat.PPTX)

Passo 5: Aplicar um preenchimento e salvar

Defina uma cor de preenchimento sólido na forma antes de salvar:

from aspose.slides_foss import (
    Presentation, SaveFormat, ShapeType, FillType, Color
)

prs = Presentation()
slide = prs.slides[0]
shape = slide.shapes.add_auto_shape(ShapeType.RECTANGLE, 100, 100, 400, 200)
shape.fill_format.fill_type = FillType.SOLID
shape.fill_format.solid_fill_color.color = Color.from_argb(255, 70, 130, 180)
shape.add_text_frame("Styled shape")
prs.save("styled.pptx", SaveFormat.PPTX)

Problemas comuns e soluções

ModuleNotFoundError: No module named 'aspose' O pacote não está instalado no ambiente Python ativo. Run pip install aspose-slides-foss no mesmo ambiente virtual que você está usando para executar o seu script. Confirme com pip show aspose-slides-foss.

FileNotFoundError quando ligarem. Presentation("path") O caminho que você passou não existe ou usa o separador errado. Use pathlib.Path a) para o Construir caminhos de forma portátil:

from pathlib import Path
from aspose.slides_foss import Presentation

prs = Presentation(str(Path("folder") / "existing.pptx"))

SaveFormat erro de importação Importação SaveFormat Direita do aspose.slides_foss Embalagem: from aspose.slides_foss import Presentation, SaveFormat

Forma adicionada mas não visível na saída Certifique-se de que as coordenadas e dimensões estão dentro dos limites do slide. Dimensões padrão do diapositivo são 9144000 UEM × 6858000 UEMA (aproximadamente 12 x 9 polegadas). Utilize valores razoáveis em: O Conselho Europeu de Lisboa, em 15 de Março. x, y, width, height Parâmetros em pontos (1 pt ≈ 12700 UEM).

Perguntas Frequentes

O aspose-slides-foss requer o Microsoft Office?

A biblioteca cria e lê. .pptx arquivos nativos em Python puro sem dependência Em Microsoft Office, na automação COM ou nas APIs do Windows.

Quais versões do Python são suportadas?

Python 3.10 ou posterior. O pacote é executado em Windows, macOS, Linux, contêineres Docker e funções sem servidor.

A biblioteca é gratuita para uso comercial?

Sim, é lançado sob a licença MIT. Você pode usá-lo, modificá -lo e redistribuí -la para qualquer finalidade, incluindo aplicações comerciais.

Posso carregar um ficheiro PPTX existente?

Passe o caminho do arquivo para a página de acesso. Presentation:

from aspose.slides_foss import Presentation, SaveFormat

prs = Presentation("existing.pptx")
print(f"Loaded {len(prs.slides)} slides")
prs.save("copy.pptx", SaveFormat.PPTX)

Posso adicionar vários slides?

Sim, usa. prs.slides.add_empty_slide(layout) Após obter um layout de prs.masters[0].layout_slides[0].