Python实现快速为PDF添加背景色或背景图片_Python

在日常办公或文档处理中，我们经常需要为 pdf 文件添加背景色或背景图片，以增强文档的视觉效果或突出重要内容。本文将介绍如何使用 free spire.pdf for python 库，通过简单的代码实现为 pdf 添加背景色和背景图片的功能。

准备工作

首先，我们需要安装 free spire.pdf for python 库。打开命令行终端，执行以下命令：

pip install spire.pdf.free

安装完成后，我们就可以开始编写代码了。需要注意的是，free spire.pdf 是免费版本，但有一定的页数限制（每个文档最多处理 10 页），对于日常小规模文档处理来说完全够用。

为 pdf 添加背景色

为 pdf 添加背景色的操作非常简单。我们只需要遍历 pdf 的每一页，设置其 backgroundcolor 属性即可。以下是一个完整的示例：

from spire.pdf.common import *
from spire.pdf import *

# 创建 pdfdocument 对象
doc = pdfdocument()

# 加载 pdf 文件
doc.loadfromfile("c:\users\administrator\desktop\input.pdf")

# 遍历文档中的所有页面
for i in range(doc.pages.count):
    # 获取当前页面
    page = doc.pages.get_item(i)

    # 设置背景颜色为浅黄色
    page.backgroundcolor = color.get_lightgreen()

# 保存文档
doc.savetofile("output.pdf")

核心代码解析

创建文档对象 ：pdfdocument() 用于实例化一个 pdf 文档对象，后续所有操作都基于该对象。
加载源文件 ：loadfromfile() 方法加载需要处理的 pdf 文件，参数为文件路径。
遍历页面 ：通过 doc.pages.count 获取文档总页数，使用 for 循环遍历每一页。
设置背景色 ：page.backgroundcolor 属性用于设置当前页面的背景色，color.get_lightgreen() 返回浅绿色的颜色对象。color 类提供了多种预定义颜色，如 get_lightblue()、get_lightyellow()、get_pink() 等，可根据需求自由选择。
保存文件 ：savetofile() 将修改后的文档保存到指定路径。

为 pdf 添加背景图片

如果你希望为 pdf 添加背景图片，可以使用 backgroundimage 属性。代码如下：

from spire.pdf.common import *
from spire.pdf import *

# 创建 pdfdocument 对象
doc = pdfdocument()

# 加载 pdf 文件
doc.loadfromfile("c:\users\administrator\desktop\input.pdf")

# 加载图片
image = stream("c:\users\administrator\desktop\img.jpg")

# 遍历文档中的所有页面
for i in range(doc.pages.count):
    # 获取当前页面
    page = doc.pages.get_item(i)

    # 设置背景图片
    page.backgroundimage = image

# 保存文档
doc.savetofile("output.pdf")

核心代码解析

创建与加载 ：与添加背景色相同，首先创建 pdfdocument 对象并加载目标 pdf 文件。
遍历页面 ：通过循环遍历文档的每一页，确保所有页面都应用相同的背景图片。
设置背景图 ：page.backgroundimage 属性接受一个 stream 对象，通过传入图片文件路径即可创建图片流。支持的图片格式包括 jpg、png、bmp 等常见格式。设置后，图片会自动铺满整个页面作为背景。
保存结果 ：最后将处理后的文档保存为新文件，原文件保持不变。