快捷導(dǎo)航

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

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

在 PDF 文檔編輯中,適當(dāng)?shù)卣{(diào)整圖片的透明度,可以幫助實現(xiàn)更平衡的版面效果,使內(nèi)容層次更清晰、視覺更協(xié)調(diào),助 Free Spire.PDF for Python,我們可以通過簡單的 Python 代碼靈活設(shè)置圖片的透明度,而無需借助復(fù)雜的圖像編輯軟件,需要的朋友可以參考下

在 PDF 文檔編輯中，適當(dāng)?shù)卣{(diào)整圖片的透明度，可以幫助實現(xiàn)更平衡的版面效果，使內(nèi)容層次更清晰、視覺更協(xié)調(diào)。無論是添加水印、背景圖像，還是在文檔中插入標(biāo)識元素，透明度的控制都能帶來更專業(yè)的呈現(xiàn)效果。

借助 Free Spire.PDF for Python，我們可以通過簡單的 Python 代碼靈活設(shè)置圖片的透明度，而無需借助復(fù)雜的圖像編輯軟件。這種方式不僅高效，還能方便地應(yīng)用于批量文檔的自動化處理。

本文將演示兩種方法：

重新設(shè)置現(xiàn)有 PDF 圖片的透明度
在 PDF 中插入一張新的半透明圖片

安裝庫

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

pip install spire.pdf.free

方法一：設(shè)置現(xiàn)有圖片的透明度

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

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)

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

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

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

代碼解析：

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

結(jié)果如下：

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

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

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

from spire.pdf import *

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

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

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

# 設(shè)置透明度（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)：設(shè)置圖片在 PDF 頁面上的繪制坐標(biāo)。
SetTransparency(0.2)：指定透明度，這里為 20% 不透明（即 80% 透明）。
DrawImage()：將圖片繪制到指定位置。

結(jié)果如下：

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

小結(jié)與拓展

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

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

拓展應(yīng)用場景：