使用Python在PDF中设置图片透明度的操作方法_Python

在 pdf 文档编辑中，适当地调整图片的透明度，可以帮助实现更平衡的版面效果，使内容层次更清晰、视觉更协调。无论是添加水印、背景图像，还是在文档中插入标识元素，透明度的控制都能带来更专业的呈现效果。

借助 free spire.pdf for python，我们可以通过简单的 python 代码灵活设置图片的透明度，而无需借助复杂的图像编辑软件。这种方式不仅高效，还能方便地应用于批量文档的自动化处理。

本文将演示两种方法：

重新设置现有 pdf 图片的透明度
在 pdf 中插入一张新的半透明图片

安装库

首先，通过 pip 安装 free 版本：

pip install spire.pdf.free

方法一：设置现有图片的透明度

如果 pdf 文件中已经包含图片（例如签名、印章或背景图），我们可以读取图片并重新绘制，以调整其透明度。

from spire.pdf import *

# 创建 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)：在指定区域绘制图片。

结果如下：

通过这种方式，可以批量调整 pdf 文件中的印章、背景图等对象的透明度，实现更柔和的视觉效果。

方法二：向 pdf 中添加一张半透明图片

如果需要在 pdf 上新添加图片（如 logo 或水印），可以直接设置透明度后绘制。

from spire.pdf import *

# 创建 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()：将图片绘制到指定位置。

结果如下：

这种方法非常适合在发票、审批文件、合同等 pdf 中自动添加印章或 logo。

小结与拓展

本文介绍了如何使用 spire.pdf for python 调整 pdf 中图片的透明度，主要包括两种方法：

方法	说明
重新设置现有图片透明度	提取 pdf 内已有图片并重新绘制，适合处理签章、背景图等场景
插入半透明图片	向 pdf 添加新图片并设置透明度，适合添加公司 logo 或水印

拓展应用场景：