Cómo comenzar con Aspose.Slides FOSS para Python

aspose-slides-foss Para Python es una biblioteca gratuita, licenciada por MIT para crear y editar. PowerPoint .pptx archivos — no Microsoft Office requerido, Python puro de PyPI.

Guía paso a paso

Paso 1: Instalar el paquete

Instalar desde PyPI con pip:

pip install aspose-slides-foss>=26.3.2

Verifique la instalación cargada correctamente:

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

Paso 2: Importar las clases necesarias

Importa los módulos que necesitas para cargar presentaciones y ahorrar:

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

Paso 3: Crea una presentación

Construye a Presentation Sin argumentos para comenzar con un solo slide blanco:

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)

Paso 4: Agregar una forma con texto

Uso slide.shapes.add_auto_shape() para insertar un rectángulo, luego llamar add_text_frame() Para añadir contenido 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)

Paso 5: Aplique un lleno y ahorra

Póngase un color de lleno sólido en la forma antes de ahorrar:

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 comunes y soluciones

ModuleNotFoundError: No module named 'aspose' El paquete no está instalado en el entorno de Python activo. pip install aspose-slides-foss en el mismo entorno virtual que está utilizando para ejecutar su script. confirmar con pip show aspose-slides-foss.

FileNotFoundError Cuando llamar Presentation("path") El camino que pasaste no existe o utiliza el separador equivocado. pathlib.Path para Construcción de caminos por vía:

from pathlib import Path
from aspose.slides_foss import Presentation

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

SaveFormat Errores de importación Importación SaveFormat directamente de la aspose.slides_foss El paquete: from aspose.slides_foss import Presentation, SaveFormat

Forma añadida pero no visible en la salida Las coordenadas y las dimensiones de seguridad están dentro de los límites del slide. son 9144000 EMUs × 6858000 EmU (aproximadamente 12 × 9 pulgadas). EMU o utilizar el x, y, width, height Parámetros en puntos (1 pt ≈ 12700 EMU).

Preguntas frecuentes

¿Es necesario que el aspose-slides-foss Microsoft Office?

La biblioteca crea y lee .pptx archivos nativos en Python puro sin dependencia Microsoft Office, COM automation o Windows APIs.

¿Qué versiones de Python se apoyan?

Python 3.10 o más tarde. el paquete se ejecuta en Windows, macOS, Linux, contenedores de Docker y funciones sin servidor.

¿La biblioteca es libre para uso comercial?

Se publica bajo la Licencia MIT. Puede utilizar, modificar y redistribuirlo para cualquier propósito, incluidas las aplicaciones comerciales.

¿Puedo cargar un archivo PPTX existente?

Si. pasar el camino de archivo a 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)

¿Puedo añadir múltiples slides?

Sí, usamos prs.slides.add_empty_slide(layout) Después de obtener un layout de prs.masters[0].layout_slides[0].