快捷導(dǎo)航

Python實現(xiàn)快速為PDF添加背景色或背景圖片

更新時間：2026年03月23日 15:03:35 作者：LSTM97

在日常辦公或文檔處理中,我們經(jīng)常需要為 PDF 文件添加背景色或背景圖片,本文將介紹如何使用 Free Spire.PDF for Python 庫,通過簡單的代碼實現(xiàn)為 PDF 添加背景色和背景圖片的功能,有需要的可以了解下

在日常辦公或文檔處理中，我們經(jīng)常需要為 PDF 文件添加背景色或背景圖片，以增強文檔的視覺效果或突出重要內(nèi)容。本文將介紹如何使用 Free Spire.PDF for Python 庫，通過簡單的代碼實現(xiàn)為 PDF 添加背景色和背景圖片的功能。

準備工作

首先，我們需要安裝 Free Spire.PDF for Python 庫。打開命令行終端，執(zhí)行以下命令：

pip install spire.pdf.free

安裝完成后，我們就可以開始編寫代碼了。需要注意的是，F(xiàn)ree Spire.PDF 是免費版本，但有一定的頁數(shù)限制（每個文檔最多處理 10 頁），對于日常小規(guī)模文檔處理來說完全夠用。

為 PDF 添加背景色

為 PDF 添加背景色的操作非常簡單。我們只需要遍歷 PDF 的每一頁，設(shè)置其 BackgroundColor 屬性即可。以下是一個完整的示例：

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

# 創(chuàng)建 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)

    # 設(shè)置背景顏色為淺黃色
    page.BackgroundColor = Color.get_LightGreen()

# 保存文檔
doc.SaveToFile("output.pdf")

核心代碼解析

創(chuàng)建文檔對象 ：PdfDocument() 用于實例化一個 PDF 文檔對象，后續(xù)所有操作都基于該對象。
加載源文件 ：LoadFromFile() 方法加載需要處理的 PDF 文件，參數(shù)為文件路徑。
遍歷頁面 ：通過 doc.Pages.Count 獲取文檔總頁數(shù)，使用 for 循環(huán)遍歷每一頁。
設(shè)置背景色 ：page.BackgroundColor 屬性用于設(shè)置當前頁面的背景色，Color.get_LightGreen() 返回淺綠色的顏色對象。Color 類提供了多種預(yù)定義顏色，如 get_LightBlue()、get_LightYellow()、get_Pink() 等，可根據(jù)需求自由選擇。
保存文件 ：SaveToFile() 將修改后的文檔保存到指定路徑。

為 PDF 添加背景圖片

如果你希望為 PDF 添加背景圖片，可以使用 BackgroundImage 屬性。代碼如下：

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

# 創(chuàng)建 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)

    # 設(shè)置背景圖片
    page.BackgroundImage = image

# 保存文檔
doc.SaveToFile("output.pdf")

核心代碼解析

創(chuàng)建與加載 ：與添加背景色相同，首先創(chuàng)建 PdfDocument 對象并加載目標 PDF 文件。
遍歷頁面 ：通過循環(huán)遍歷文檔的每一頁，確保所有頁面都應(yīng)用相同的背景圖片。
設(shè)置背景圖 ：page.BackgroundImage 屬性接受一個 Stream 對象，通過傳入圖片文件路徑即可創(chuàng)建圖片流。支持的圖片格式包括 JPG、PNG、BMP 等常見格式。設(shè)置后，圖片會自動鋪滿整個頁面作為背景。
保存結(jié)果 ：最后將處理后的文檔保存為新文件，原文件保持不變。