介绍

Aspose.Slides FOSS for Python 现已在 PyPI 上提供:一个免费、MIT 许可证的库,可在 Python 中完全创建、读取和编辑 PowerPoint .pptx 文件,无需依赖 Microsoft Office 或任何专有运行时。

该库面向需要以编程方式生成或操作演示文稿文件的开发者:从数据自动生成幻灯片、从上传的 PPTX 文件提取文本和元数据、构建基于演示的报告流水线,或将演示创建嵌入到 Web 应用程序中。由于 aspose-slides-foss 是纯 Python,且仅依赖 lxml,它在 Windows、macOS、Linux 和 Docker 容器上部署方式完全相同。

关键特性

  • 完整的往返 PPTX 支持:打开任何 .pptx 文件,修改其内容,并保存回去而不会丢失库尚未理解的未知 XML 部分。
  • 幻灯片管理:使用 prs.slides 添加、删除和遍历幻灯片;演示文稿在 slides.Presentation() 之后以一张空白幻灯片开始。
  • AutoShapes、表格和连接线:通过 slide.shapes.add_auto_shape() 插入形状,通过 slide.shapes.add_table() 插入表格数据,通过 slide.shapes.add_connector() 在形状之间插入可视连接线。
  • 富文本格式化:使用 PortionFormat 对字符级别的文本进行格式化:字体大小、粗体、斜体、下划线,以及通过 FillType.SOLIDColor.from_argb() 设置 ARGB 颜色。
  • 填充类型:对任意形状应用 FillType.SOLIDGRADIENTPATTERNPICTURE 填充。
  • 视觉效果:通过 shape.effect_format 实现外阴影、发光、柔边、模糊、反射和内阴影。
  • 3D 格式化:通过 shape.three_d_format 实现斜角、摄像机、灯光装置、材质和拉伸深度。
  • 演讲者备注:通过 notes_slide_manager.add_notes_slide() 为每张幻灯片附加备注文本。
  • 线程式评论:添加带有作者元数据和幻灯片位置的评论。
  • 嵌入图像:从文件路径、字节或 io.BytesIO 流中嵌入。
  • 文档属性:读取和写入核心、应用程序和自定义属性。

入门

从 PyPI 安装。需要 Python 3.10 或更高版本;lxml 将自动安装。

pip install aspose-slides-foss

使用形状创建您的第一个演示文稿并保存它:

import aspose.slides_foss as slides
from aspose.slides_foss.export import SaveFormat
from aspose.slides_foss import ShapeType

with slides.Presentation() as prs:
    slide = prs.slides[0]
    shape = slide.shapes.add_auto_shape(ShapeType.RECTANGLE, 50, 50, 400, 120)
    shape.add_text_frame("Hello from Aspose.Slides FOSS!")
    prs.save("hello.pptx", SaveFormat.PPTX)

始终在 with 块中使用 Presentation;这可确保在块退出时释放所有内部资源。

文本格式示例

import aspose.slides_foss as slides
from aspose.slides_foss import ShapeType, NullableBool, FillType
from aspose.slides_foss.drawing import Color
from aspose.slides_foss.export import SaveFormat

with slides.Presentation() as prs:
    shape = prs.slides[0].shapes.add_auto_shape(ShapeType.RECTANGLE, 50, 50, 500, 150)
    tf = shape.add_text_frame("Bold heading in corporate blue")
    fmt = tf.paragraphs[0].portions[0].portion_format
    fmt.font_height = 28
    fmt.font_bold = NullableBool.TRUE
    fmt.fill_format.fill_type = FillType.SOLID
    fmt.fill_format.solid_fill_color.color = Color.from_argb(255, 0, 70, 127)
    prs.save("formatted.pptx", SaveFormat.PPTX)

当前限制

以下区域在此版本中触发 NotImplementedError

  • 图表、SmartArt 和 OLE 对象
  • 动画和幻灯片切换
  • 导出为 PDF、HTML、SVG 或图像格式
  • 超链接、操作设置、VBA 宏和数字签名

在加载过程中遇到的未知 XML 部分在保存时会原样保留,因此其他工具生成的 PPTX 文件能够安全往返。

另请参阅