使用Python在PDF中設置圖片透明度的操作方法

更新時間：2025年11月24日 09:14:11 作者：大丸子

在 PDF 文檔編輯中,適當地調整圖片的透明度,可以幫助實現更平衡的版面效果,使內容層次更清晰、視覺更協調,助 Free Spire.PDF for Python,我們可以通過簡單的 Python 代碼靈活設置圖片的透明度,而無需借助復雜的圖像編輯軟件,需要的朋友可以參考下

安裝庫

首先，通過 pip 安裝 Free 版本：

pip install spire.pdf.free

方法一：設置現有圖片的透明度

如果 PDF 文件中已經包含圖片（例如簽名、印章或背景圖），我們可以讀取圖片并重新繪制，以調整其透明度。

from spire.pdf import *

# 創(chuàng)建 PdfDocument 實例并加載文件
pdf = PdfDocument()
pdf.LoadFromFile("Sample.pdf")

# 獲取第一頁
page = pdf.Pages.get_Item(0)

# 獲取頁面上的第一張圖片及其位置
imageHelper = PdfImageHelper()
imagesInfo = imageHelper.GetImagesInfo(page)
imageStream = imagesInfo[0].Image
bounds = imagesInfo[0].Bounds

# 刪除原有圖片
imageHelper.DeleteImage(imagesInfo[0])

# 從流生成新的圖片對象
image = PdfImage.FromStream(imageStream)

# 設置透明度（0~1，數值越小越透明）
page.Canvas.SetTransparency(0.3)

# 在相同位置重新繪制圖片
page.Canvas.DrawImage(image, bounds)

# 保存結果
pdf.SaveToFile("output/SetExistingImageTransparency.pdf")
pdf.Close()

代碼解析：

PdfImageHelper()：用于提取頁面中的圖片信息。
GetImagesInfo(page)：返回頁面中所有圖片的信息，包括 Image 和 Bounds（位置和大小）。
DeleteImage()：刪除指定的圖片對象。
SetTransparency(0.3)：設置透明度，范圍為 0（完全透明）到 1（完全不透明）。
DrawImage(image, bounds)：在指定區(qū)域繪制圖片。

結果如下：

通過這種方式，可以批量調整 PDF 文件中的印章、背景圖等對象的透明度，實現更柔和的視覺效果。

方法二：向 PDF 中添加一張半透明圖片

如果需要在 PDF 上新添加圖片（如 Logo 或水?。?，可以直接設置透明度后繪制。

from spire.pdf import *

# 創(chuàng)建 PdfDocument 實例并加載文件
pdf = PdfDocument()
pdf.LoadFromFile("Sample.pdf")

# 獲取第一頁
page = pdf.Pages.get_Item(0)

# 讀取要添加的圖片
image = PdfImage.FromFile("Stamp.png")

# 設置透明度（0~1）
page.Canvas.SetTransparency(0.2)

# 在指定位置繪制圖片
page.Canvas.DrawImage(image, PointF(100.0, 180.0))

# 保存修改后的文件
pdf.SaveToFile("output/AddTranslucentPicture.pdf")
pdf.Close()

代碼說明：

PdfImage.FromFile()：從文件中加載一張圖片，例如公司 Logo 或印章圖。
PointF(x, y)：設置圖片在 PDF 頁面上的繪制坐標。
SetTransparency(0.2)：指定透明度，這里為 20% 不透明（即 80% 透明）。
DrawImage()：將圖片繪制到指定位置。

結果如下：

這種方法非常適合在發(fā)票、審批文件、合同等 PDF 中自動添加印章或 Logo。

小結與拓展

本文介紹了如何使用 Spire.PDF for Python 調整 PDF 中圖片的透明度，主要包括兩種方法：

方法	說明
重新設置現有圖片透明度	提取 PDF 內已有圖片并重新繪制，適合處理簽章、背景圖等場景
插入半透明圖片	向 PDF 添加新圖片并設置透明度，適合添加公司 Logo 或水印

拓展應用場景：