在 PDF 文档中调整图像透明度对实现专业的文档效果至关重要。设置适当的图片透明度有助于图像与其他图像或文字内容更好地叠加，并与背景或底层元素自然融合。这样不仅能提升文档的视觉吸引力，还能在图文密集的场景下呈现统一、精致的外观。本文将演示如何在 Python 项目中，使用 Spire.PDF for Python 来设置 PDF 图像的透明度。
安装 Spire.PDF for Python
本教程需要用到 Spire.PDF for Python 和 plum-dispatch v1.7.4。可以通过以下 pip 命令将它们轻松安装到 Windows 中。
pip install Spire.PDF如果您不确定如何安装，请参考：如何在 Windows 中安装 Spire.PDF for Python
添加指定透明度的图像到 PDF 文档
使用 Spire.PDF for Python 中的 PdfPageBase.Canvas.DrawImage() 方法可以将图像绘制到 PDF 页面的指定位置。在绘制之前，可以通过 PdfPageBase.Canvas.SetTransparency() 方法设置画布的透明度，从而控制所绘制图像的透明效果。以下是详细操作步骤：
- 创建 PdfDocument 类的对象，并使用 PdfDocument.LoadFromFile() 方法加载 PDF 文档。
- 使用 PdfDocument.Pages.get_Item() 方法获取文档中的页面。
- 使用 PdfImage.FromFile() 方法加载图像。
- 通过 PdfPageBase.Canvas.SetTransparency() 方法设置画布的透明度。
- 使用 PdfPageBase.Canvas.DrawImage() 方法将图像绘制到页面上。
- 使用 PdfDocument.SaveToFile() 方法保存文档。
- Python
from spire.pdf import *
# 创建一个PdfDocument实例
pdf = PdfDocument()
# 加载一个PDF文件
pdf.LoadFromFile("示例.pdf")
# 获取第一页
page = pdf.Pages.get_Item(0)
# 加载一张图片
image = PdfImage.FromFile("Screen.jpg")
# 设置画布的透明度
page.Canvas.SetTransparency(0.1)
# 在指定位置绘制图片
page.Canvas.DrawImage(image, PointF(80.0, 70.0))
# 保存文档
pdf.SaveToFile("output/添加透明度图片到PDF.pdf")
pdf.Close()
调整 PDF 页面上现有图片的透明度
要调整 PDF 页面上现有图像的透明度，可以获取图像及其边界信息并删除该图像，然后在相同位置以指定透明度重新绘制图像。这样可以调整图像的透明效果，同时保持其原始位置。具体操作步骤如下：
- 创建 PdfDocument 类的对象，并使用 PdfDocument.LoadFromFile() 方法加载 PDF 文档。
- 使用 PdfDocument.Pages.get_Item() 方法获取文档中的页面。
- 通过 PdfPageBase.ImagesInfo[].Image 属性获取页面上的图像为图像流，并通过 PdfPageBase.ImagesInfo[].Bounds 属性获取图像的边界。
- 使用 PdfPageBase.DeleteImage() 方法从页面中删除该图像。
- 使用 PdfImage.FromStream() 方法通过图像流创建 PdfImage 实例。
- 通过 PdfPageBase.Canvas.SetTransparency() 方法设置画布的透明度。
- 使用 PdfPageBase.Canvas.DrawImage() 方法在相同位置以指定透明度重新绘制图像。
- 使用 PdfDocument.SaveToFile() 方法保存文档。
- Python
from spire.pdf import *
# 创建一个PdfDocument实例
pdf = PdfDocument()
# 加载一个PDF文件
pdf.LoadFromFile("示例1.pdf")
# 获取第一页
page = pdf.Pages.get_Item(0)
# 获取页面上的第一张图像作为流及其边界
imageStream = page.ImagesInfo[0].Image
bounds = page.ImagesInfo[0].Bounds
# 删除原始图像
page.DeleteImage(0)
# 使用图像流创建一个PdfImage实例
image = PdfImage.FromStream(imageStream)
# 设置画布的透明度
page.Canvas.SetTransparency(0.3)
# 使用画布在同一位置绘制新图像
page.Canvas.DrawImage(image, bounds)
# 保存文档
pdf.SaveToFile("output/调整PDF图片透明度.pdf")
pdf.Close()
申请临时 License
如果您希望删除结果文档中的评估消息，或者摆脱功能限制，请该Email地址已收到反垃圾邮件插件保护。要显示它您需要在浏览器中启用JavaScript。获取有效期 30 天的临时许可证。
