介绍
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.SOLID和Color.from_argb()设置 ARGB 颜色。 - 填充类型:对任意形状应用
FillType.SOLID、GRADIENT、PATTERN或PICTURE填充。 - 视觉效果:通过
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 文件能够安全往返。