Python-pptx教程之一从零开始生成PPT文件

news2025/1/10 20:33:43

简介

python-pptx是一个用于创建、读取和更新PowerPoint（.pptx）文件的python库。
典型的用途是根据动态内容（如数据库查询、分析数据等），将这些内容自动化生成PowerPoint演示文稿，将数据可视化，方便查看
我们也可以用它做办公自动化，定义一套模板，然后根据给出的内容批量生成PPT文件，大大提高我们的办公效率

Python-pptx的Github地址

https://github.com/scanny/python-pptx

开发文档

https://python-pptx.readthedocs.io/en/latest/

安装python-pptx

pip install python-pptx

本文使用的版本为0.6.21

使用python-pptx创建新的PPT

生成一个全新的PPT文件，这种方式适用于所有样式都是由代码来控制的场景
幻灯片效果

在这里插入图片描述
实现以上效果的代码

from pptx import Presentation

# 创建一个新的 Presentation 对象
prs = Presentation()
# 获取一个包含主标题和副标题的幻灯片版式
title_slide_layout = prs.slide_layouts[0]
# 将幻灯片加入到PPT中
slide = prs.slides.add_slide(title_slide_layout)
# 获取主标题
title = slide.placeholders[0]
# 获取副标题
subtitle = slide.placeholders[1]

title.text = "Hello, World!"
subtitle.text = "python-pptx create it"
# 保存创建的PPT文件
prs.save('G:/simple_ppt/test/test1.pptx')

上例中的prs.slide_layouts[0] 获取幻灯片的版式，幻灯片的版式共有11个，如下所示
在这里插入图片描述
从左到右依次是slide_layouts[0]、slide_layouts[1] 一直到 slide_layouts[10]，通过对应的下标即可获取对应的幻灯片版式

Tips：
上面代码中的slide = prs.slides.add_slide(title_slide_layout)
即prs.slides 代表的是当前PPT中所有幻灯片的集合，通过add_slide 添加一张幻灯片后拿到的slide ，后续针对这个slide 的各种操作也就是单张幻灯片的操作

修改幻灯片大小

1、直接通过slide_width和slide_height指定

from pptx.util import Cm

prs = Presentation()
prs.slide_width = Cm(33.85)
prs.slide_height = Cm(19.02)

2、通过模板指定
可以先自定义一个指定了宽高的空白页PPT模板，创建Presentation对象时引用它，后续创建的幻灯片就能继承到对应的宽高大小

prs = Presentation("G:/simple_ppt/test/template.pptx")

创建文本

段落创建

想要在幻灯片中添加文本，先要通过add_textbox创建一个文本框，然后取得text_frame来进行操作

from pptx import Presentation
from pptx.util import Cm

def test_blog_text_add():
    prs = Presentation()
    prs.slide_width = Cm(33.85)
    prs.slide_height = Cm(19.02)

    bullet_slide_layout = prs.slide_layouts[6]    # 空白版式
    slide = prs.slides.add_slide(bullet_slide_layout)

    # 添加文本框
    tx_box = slide.shapes.add_textbox(left=Cm(2.58), top=Cm(1.16), width=Cm(28), height=Cm(2.36))
    tf = tx_box.text_frame

    p0 = tf.paragraphs[0]
    p0.text = '这是第一行段落'

    p1 = tf.add_paragraph()
    p1.text = '这是新增的第二行段落'

    run = p1.add_run()
    run.text = '。第二行结尾直接添加文字'

    prs.save("G:/simple_ppt/test/blog_test.pptx")

生成效果如下
在这里插入图片描述

Tips:
上面代码中的：tx_box = slide.shapes.add_textbox(…
slide.shapes代表的是当前幻灯片中所有元素的集合，如文本框、图片、图标、视频等等可框选的东西，都是shapes，所以若要添加什么东西，也是通过shapes.add_xxx的方式来实现

文本样式添加
一、自动换行

如果我们输入的文本大于文本框的长度时，默认是不会换行的，可以使用tf.word_wrap来指定自动换行

tf = tx_box.text_frame
tf.word_wrap = True
二、文本布局样式

文本框中的文本默认是上方对齐，可以使用tfvertical_anchor来指定文本的布局方式

from pptx.enum.text import MSO_ANCHOR

tf = tx_box.text_frame
tf.vertical_anchor = MSO_ANCHOR.MIDDLE
  • TOP：将文本与文本框顶部对齐
  • MIDDLE：垂直居中文本
  • BOTTOM：将文本与文本框底部对齐

参考：https://python-pptx.readthedocs.io/en/latest/api/enum/MsoVerticalAnchor.html
注意，这个只是指定了文本垂直方向上的移动，如想文本基于整个文本框居中需要指定段落的布局方式
设置文本段落布局可以通过设置p.alignment 的方式

from pptx.enum.text import MSO_ANCHOR, PP_ALIGN

tf = tx_box.text_frame
tf.vertical_anchor = MSO_ANCHOR.MIDDLE
p0 = tf.paragraphs[0]
p0.text = '这是第一行段落'
p0.alignment = PP_ALIGN.CENTER

效果如图
在这里插入图片描述
PP_ALIGN的参数有以下几个

  • CENTER：居中对齐
  • DISTRIBUTE：在一行中从左到右均匀分布
  • JUSTIFY：每行都在页边空白处开始和结束，并调整单词之间的间距，使该行正好填满段落的宽度
  • JUSTIFY_LOW：在单词之间使用少量空格进行对齐
  • LEFT：默认的，左对齐
  • RIGHT：右对齐
  • THAI_DISTRIBUTE：泰语分散对齐，输入泰语时候指定

以上效果就不一一演示了，自己尝试下选择合适的就行

参考：

https://python-pptx.readthedocs.io/en/latest/api/enum/PpParagraphAlignment.html

三、文字样式修改

文字的字体、字号、加粗、斜体、下划线、颜色、超链接等，这些样式通过font 来设置
参数较多，直接上代码

from pptx import Presentation
from pptx.util import Cm, Pt
from pptx.dml.color import RGBColor
from pptx.enum.text import MSO_ANCHOR, PP_ALIGN

def test_blog_text_add():
    prs = Presentation()
    prs.slide_width = Cm(33.85)
    prs.slide_height = Cm(19.02)

    bullet_slide_layout = prs.slide_layouts[6]
    slide = prs.slides.add_slide(bullet_slide_layout)

    # 添加文本框
    tx_box = slide.shapes.add_textbox(left=Cm(2.58), top=Cm(1.16), width=Cm(28.47), height=Cm(5))
    tf = tx_box.text_frame
    tf.word_wrap = True     # 自动换行
    tf.vertical_anchor = MSO_ANCHOR.MIDDLE  # 垂直居中

    p0 = tf.paragraphs[0]   # 第一行段落
    p0.alignment = PP_ALIGN.CENTER  # 设置段落文字居中
    p0.line_spacing = 1.3   # 间距
    p0.font.name = 'Arial Black' # 字体
    p0.font.size = Pt(40)   # 字号
    p0.font.italic = True   # 斜体
    p0.font.bold = True     # 粗体
    p0.font.underline = True    # 显示下划线
    p0.font.color.rgb = RGBColor(255, 0, 0)  # 设置红色
    p0.text = 'Hello World!'

    p1 = tf.add_paragraph()  # 添加新段落
    p1.text = '这是第二行段落'

    run = p1.add_run()
    run.text = "。第二行结尾直接添加文字"
    run.hyperlink.address = 'https://www.baidu.com'    # 添加超链接

    prs.save("G:/simple_ppt/test/blog_test.pptx")

生成的效果
在这里插入图片描述
注意，当给一个文本添加了超链接后，文字的颜色就无法指定了，会变成图中这种蓝色加下划线的样式

段落间距设置

可通过line_spacing指定

p0.line_spacing = 1.3
文字大小自动改变

有时候我们要输入的文本太长，而文本框区域有限，此时可以指定文字的大小根据文本框的大小自动调整文字的大小

from pptx.enum.text import MSO_AUTO_SIZE

tf = tx_box.text_frame
tf.auto_size = MSO_AUTO_SIZE.TEXT_TO_FIT_SHAPE

MSO_AUTO_SIZE还有其它三个参数

  • NONE：不进行任何自动调整，文字可以超出文本框的边界
  • SHAPE_TO_FIT_TEXT：根据文字的内容自动调整文本框的宽度和高度，这样可以保持文字的大小不变
  • TEXT_TO_FIT_SHAPE：根据文本框的大小自动调整文字的大小，这样可以让文字完全填充文本框

参考：

https://python-pptx.readthedocs.io/en/latest/api/enum/MsoAutoSize.html

文本层级设置

文字层级一般用来处理段落的缩进，对内容进行层级管理，通过level 来指定，每个paragraph的level默认就是0

p2 = tf.add_paragraph()
p2.text = '第一层'
p2.level = 0

p3 = tf.add_paragraph()
p3.text = '第二层'
p3.level = 1

p4 = tf.add_paragraph()
p4.text = '第三层'
p4.level = 2

效果如下
在这里插入图片描述

创建图片

使用add_picture 可以添加图片，指定对应的坐标即可

img_path = 'G:/simple_ppt/res/picture.png'
slide.shapes.add_picture(img_path, left=Cm(2.58), top=Cm(6.16), width=Cm(8.3), height=Cm(5.13))

left和top表示图片左上角顶点分别距离幻灯片左边框和上边框的距离，width和height表示图片的宽和高

创建视频或音频

添加视频使用add_movie

video_path = 'G:/simple_ppt/res/movie.mp4'
slide.shapes.add_movie(video_path, Cm(11.66), Cm(6.22), Cm(8.11), Cm(5.07), mime_type='video/mp4')

视频显示的时候不会自动获取视频里的画面作为预览图，只会显示一个默认的喇叭图标，若想要根据视频的画面来生成预览图，可以借助OpenCV工具来获取视频帧存为图片，然后通过poster_frame_image参数来指定

import cv2

video_path = 'G:/simple_ppt/res/movie.mp4'
cap = cv2.VideoCapture(video_path)
cap.set(cv2.CAP_PROP_POS_FRAMES, 0)  # 设置要获取的帧
ret, frame = cap.read()
cv2.imwrite(save_poster_temp, frame)
cap.release()

slide.shapes.add_movie(video_path, Cm(11.66), Cm(6.22), Cm(8.11), Cm(5.07), mime_type='video/mp4', poster_frame_image=save_poster_temp)

Python-pptx中并没有直接提供添加音频的方法，不过其实音频也可以通过add_movie来指定，只需要修改ime_type参数为audio/mp3

audio_path = 'G:/simple_ppt/res/audio.mp3'
slide.shapes.add_movie(audio_path, Cm(19.77), Cm(6.22), Cm(8.11), Cm(5.07), mime_type='audio/mp3')

效果如下
在这里插入图片描述

创建形状图形

Python-pptx中支持添加形状图形，也就是下面这些
在这里插入图片描述
可通过add_shape来添加

from pptx.enum.shapes import MSO_SHAPE

slide.shapes.add_shape(MSO_SHAPE.STAR_5_POINT, left=Cm(28.83), top=Cm(6.87), width=Cm(3.7), height=Cm(3.7))

STAR_5_POINT表示一个五角星，更多形状参数可查看以下链接

https://python-pptx.readthedocs.io/en/latest/api/enum/MsoAutoShapeType.html#msoautoshapetype

形状图形的一些属性设置

shape = slide.shapes.add_shape(MSO_SHAPE.STAR_5_POINT, left=Cm(28.83), top=Cm(6.87), width=Cm(3.7), height=Cm(3.7))
shape.rotation = 45  # 旋转图标45°
shape.shadow.inherit = True  # 是否取消倒影显示
shape.fill.solid()  # 设置这个后才能通过下面的fore_color来设置颜色
shape.fill.fore_color.rgb = RGBColor(255, 255, 0)  # 修改填充颜色
shape.line.color.rgb = RGBColor(255, 0, 0)  # 修改边框颜色
shape.line.width = Cm(0.1)  # 修改边框宽度

还可以通过dash_style来指定边框的线条样式

from pptx.enum.dml import MSO_LINE

shape.line.dash_style = MSO_LINE.DASH  # 设置边框为虚线

MSO_LINE其它参数：

  • MSO_LINE.SOLID：实线
  • MSO_LINE.DASH：短划线
  • MSO_LINE.DASH_DOT：点划线
  • MSO_LINE.DASH_DOT_DOT：双点划线
  • MSO_LINE.LONG_DASH：长划线
  • MSO_LINE.LONG_DASH_DOT：长点划线
  • MSO_LINE.ROUND_DOT：圆点线
  • MSO_LINE.SQUARE_DOT：方点线

五角星显示的效果
在这里插入图片描述如果不想要图形的边框，可以使用以下方法将边框指定为透明

shape.line.fill.background()

创建幻灯片背景

可以通过slide的background来指定纯色背景

bg = slide.background
bg.fill.solid()
bg.fill.fore_color.rgb = RGBColor(219, 238, 244)

python-pptx库并没有直接提供设置图片作为幻灯片背景的方法，但可以通过将图片设置为铺满整个幻灯片来达到同样的效果

img_path = "G:/bg_image.png"
slide.shapes.add_picture(img_path, Cm(0), Cm(0), width=prs.slide_width, height=prs.slide_height)

slide_width和slide_height获取的分别是整张幻灯片的宽和高

这里要注意图片的层级问题，由于没有提供设置图片层级的方法，所以作为背景的图片应该放在构建幻灯片的第一位

纯色背景效果
在这里插入图片描述

创建幻灯片备注信息

幻灯片底部的备注信息，在分屏预览时可用于提示演讲人更详细的幻灯片内容细节
通过has_notes_slide来判断幻灯片是否有备注，通过以下代码可以获得幻灯片的备注信息

if slide.has_notes_slide:
    text_frame = slide.notes_slide.notes_text_frame
    print("备注文本：", text_frame.text)

若想修改备注信息，直接通过text指定即可

text_frame = slide.notes_slide.notes_text_frame
text_frame.text = "被修改的备注信息"

备注修改效果
在这里插入图片描述

总结

本篇文章介绍了如何使用python-pptx框架生成PPTX文件的方法，通过以上学习，可以掌握如何通过Python-pptx框架控制幻灯片大小、创建各种样式的文本、在幻灯片中添加图片、视频和音频，添加形状图形及如何修改它的样式，如何设置幻灯片的背景和备注信息等技能

下一篇将会介绍如何针对已有的PPT模板进行修改

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.coloradmin.cn/o/1128471.html

如若内容造成侵权/违法违规/事实不符，请联系多彩编程网进行投诉反馈，一经查实，立即删除！

相关文章

ES6初步了解生成器

ES6初步了解生成器

生成器函数是ES6提供的一种异步编程解决方案，语法行为与传统函数完全不同 语法： function * fun(){ } function * gen(){console.log("hello generator");}let iterator gen()console.log(iterator)打印： 我们发现没有打印”hello…
阅读更多...
计算机组成原理（一目了然的顶级总纲）（持续更新！）

计算机组成原理（一目了然的顶级总纲）（持续更新！）

文章目录 886冯诺依曼计算机计算机的五大部件（又称五大字系统）细化的计算机组成框图存储器 886 计算机系统由“硬件”和“软件”两大部分组成。 计算机的软件通常又可以分为两大类：系统软件和应用软件。 冯诺依曼计算机 数学家冯诺依曼&am…
阅读更多...
MySQL数据库增删改查

MySQL数据库增删改查

删除表 drop table 表名； drop table if exists 表名；修改表 修改表名 alter table 表名 rename to 新表名；添加列 alter table 表名 add 列名 数据类型；删除列 alter table 表名 drop 列名；修改数据类型 alter …
阅读更多...
WorkPlus专注私有化部署，为企业安全打造超级沟通协作APP

WorkPlus专注私有化部署，为企业安全打造超级沟通协作APP

在如今全球化竞争和高速发展的商业环境中，企业内部的沟通和协作至关重要。面对众多的通讯和协作平台，WorkPlus独辟蹊径，专注私有化部署，致力于为企业打造安全专属、自主可控的超级沟通协作APP。正是这一专注与创新，让W…
阅读更多...
发表《Nature》！哈佛大学团队成功研发自纠错量子计算机

发表《Nature》！哈佛大学团队成功研发自纠错量子计算机

（图片来源：网络） 量子计算机能达到当今最快的超级计算机也无法达到的速度和效率。然而，该技术尚未大规模推广和商业化，很大程度上是因为它无法自我纠错。与经典计算机不同，量子计算机无法通过一遍又一遍地…
阅读更多...
双赢！企业咨询行业和低代码工具的破局之路

双赢！企业咨询行业和低代码工具的破局之路

对于传统咨询企业来说，主要专注于流程和功能方面的咨询，在信息化时代中，以流程和业务驱动的模式为基础进行战略咨询、管理咨询和业务咨询，作为传统企业的外脑，在大数据时代，咨询行业在数智化时代如何应对自…
阅读更多...
发表《数学》期刊！西班牙研究人员成功应用量子计算模型来预测多种疾病

发表《数学》期刊！西班牙研究人员成功应用量子计算模型来预测多种疾病

Jos Luis Salmern 将量子计算应用于医疗保健领域（图片来源：网络） 谷歌量子人工智能（AI）研究小组的Sergio Boixo表示，量子计算还处于起步阶段，虽然很难预测其未来，但该技术已取得了一…
阅读更多...
lvs+keepalived: 高可用集群

lvs+keepalived: 高可用集群

lvskeepalived: 高可用集群 keepalived为lvs应运而生的高可用服务。lvs的调度器无法做高可用，于是keepalived软件。实现的是调度器的高可用。 但是：keepalived不是专门为集群服务的，也可以做其他服务器的高可用。 lvs的高可用集群&#xf…
阅读更多...
第九章 无线网络和移动网络 | 计算机网络（谢希仁 第八版）

第九章 无线网络和移动网络 | 计算机网络（谢希仁 第八版）

文章目录 第九章 无线网络和移动网络9.1 无线局域网WLAN9.1.1 无线局域网的组成9.1.2 802.11局域网的物理层9.1.3 802.11局域网的MAC层协议9.1.4 802.11局域网的MAC帧 9.2 无线个人区域网WPAN9.3 无线城域网WMAN9.4 蜂窝移动通信网9.4.1 蜂窝无线通信技术简介9.4.2 移动IP9.4.3…
阅读更多...
1. 概述

1. 概述

1.概述 1.1 信息时代的计算机网络 1.1.1 计算机网络的各类应用 1.1.2 计算机网络带来的负面问题 1.2 因特网概述 1.2.1 网络、互联网与因特网的区别与关系 若干个节点（Node）和链路（Link）互连形成了网络（Network&…
阅读更多...
Flask后端开发(一)-基础知识和前期准备

Flask后端开发(一)-基础知识和前期准备

目录 1.背景介绍1.1. 项目背景1.2. 项目难点1.3. 项目环境 2. flask后端开发实现的功能3. flask部署和前后端对接3.1. flask运行配置和服务器部署3.2. flask前后端传参 4. 后端测试工具4.1. 工具介绍4.2. 工具使用 后记 1.背景介绍 1.1. 项目背景 就是前几个月临时接手了一个…
阅读更多...
Linux基础命令4——Linux快捷键与帮助命令

Linux基础命令4——Linux快捷键与帮助命令

目录 Linux快捷键 Linux常用帮助命令 help命令——只适用于于内置命令 --help命令——只适用于外置命令 内外部都可使用的帮助命令 man命令 info命令 Linux快捷键 ctrlshift加号 放大屏幕 ctrl减号 缩小屏幕 ctrl l …
阅读更多...
28、Flink 的SQL之DROP 、ALTER 、INSERT 、ANALYZE 语句

28、Flink 的SQL之DROP 、ALTER 、INSERT 、ANALYZE 语句

Flink 系列文章 1、Flink 部署、概念介绍、source、transformation、sink使用示例、四大基石介绍和示例等系列综合文章链接 13、Flink 的table api与sql的基本概念、通用api介绍及入门示例 14、Flink 的table api与sql之数据类型: 内置数据类型以及它们的属性 15、Flink 的ta…
阅读更多...
中国技术的对外输出：Telegram也开始搞小程序应用了

中国技术的对外输出：Telegram也开始搞小程序应用了

Telegram 宣布为其开发者提供了一项“能够在其中运行迷你应用”的新功能（ 迷你应用即 Mini App，下文中以“小程序”代替）。 在 Telegram 的博客中，开发人员介绍可以使用 JavaScript 构建自己的迷你应用 在一篇博客文章中&#xf…
阅读更多...
蓝桥杯 Java 青蛙过河

蓝桥杯 Java 青蛙过河

import java.util.Scanner; // 1:无需package // 2: 类名必须Main, 不可修改/**二分法从大（n）到小找足够小的步长前缀和记录每个位置的前面有的总石头数（一个石头表示可以容纳一个青蛙，一位置有多少个石头hi就是多少）&…
阅读更多...
2023/10/24 MySQL学习

2023/10/24 MySQL学习

列表查询 in的用法,括号里面跟的应该是具体值,可填多个 select 表中变量名 from 表名 where 变量名 like ___... 一个下划线代表一个字符,多个就是多个字符 %号是任意多字符 %号的用法 %任意字符串 代表查找以这个字符串结尾的变量名 %任意字符串% 查找以这个字符串在变…
阅读更多...
PPT放映时显示安全警告：已阻止OLE操作。如果选择启用OLE操作，您的计算机可能不再安全。如果不信任此演示文稿的来源，请不要启用此内容

PPT放映时显示安全警告：已阻止OLE操作。如果选择启用OLE操作，您的计算机可能不再安全。如果不信任此演示文稿的来源，请不要启用此内容

PPT放映时显示安全警告：已阻止OLE操作。如果选择启用OLE操作，您的计算机可能不再安全。如果不信任此演示文稿的来源，请不要启用此内容。 ⚙️1.软件环境⚙️🔍2.问题描述🔍🐡3.解决方法🐡&#…
阅读更多...
MS5192T/MS5193T——低噪声、低功耗、16/24 位∑-ΔADC

MS5192T/MS5193T——低噪声、低功耗、16/24 位∑-ΔADC

MS5192T/MS5193T 是一款适合高精度测量应用的低功耗、低 噪声、三通道差分输入的 16bit/24bit 模数转换器。其内部集成了 输入缓冲器、低噪声仪表放大器，当增益设置为 64 ，更新速率为 4.17Hz 时，均方根噪声为 25nV 。集成了精密低噪声、低漂移…
阅读更多...
ITSource 分享 第3期【在线个人网盘】

ITSource 分享 第3期【在线个人网盘】

项目介绍 本期给大家介绍一个在线个人网盘 系统. 可以上传，下载，分享文件。 一 业务介绍 本系统分为以下几个模块: 1.登录注册 除了账号密码登录，如果配置了qq邮箱配置的话，还支持qq一键授权登录。 2.首页大盘 首页是个人网盘…
阅读更多...
适用于物联网的UI设计工具都有哪些？

适用于物联网的UI设计工具都有哪些？

随着科学技术的飞速发展，“万物相连的互联网”时代逐渐成为现实。如今，物联网已经不是什么新词了。事实上，早在各种屏幕设备诞生之前，人们就与物理世界交织在一起，产生了无数的互动。如何将人们多年积累的互动经验与物…
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023