使用IRONPDF FOR PYTHON

如何在 Python 中給 PDF 檔案添加浮水印

查克尼思·賓

2023年12月24日

已更新 2024年10月7日

介紹

隨著 PDF 的通用應用，Python PDF 水印技術的使用正在增加。 PDF 檔案無處不在——從辦公室到教室，甚至在我們的個人生活中。它們是共享文件的首選，因為無論你在哪裡打開，它們看起來都一樣。但是你是否曾想過在這些 PDF 上加上你的標記？可能是一個標誌、一個簽名，或者只是一個簡單的「機密」印章？這正是浮水印發揮作用的地方，而這項技能既實用又引人注目。這本適合初學者的指南將教你如何使用Python和名為IronPDF的PDF庫向PDF文件添加浮水印。那麼，讓我們深入研究並開始創建屬於你的獨特PDF吧！

浮水印的重要性

水印在 PDF 文件中有多種用途，從聲明所有權到確保機密性。它們可以是文字浮水印、圖片浮水印，或兩者兼具，提供了您傳達信息或保護文件的多樣化選擇。

您將學習的內容

PDF 操作的基本概念
在 Python 中安裝和使用 IronPDF 庫的步驟
PDF文件加水印的方法
處理和處理多個 PDF 文件
有效輸出和保存加水印 PDF 文件的方法
在本指南結束時，您將熟練使用 IronPDF 與 Python 為 PDF 檔案添加浮水印，提升其專業性和安全性。

設定您的環境

在深入了解 PDF 加水印的具體細節之前，建立 proper setup 是至關重要的。這包括安裝 Python，一種多功能的編程語言，以及專門用於 PDF 操作的 IronPDF 函式庫。

Python 安裝

Python 是一種強大且使用者友好的程式語言。如果您還沒有安裝 Python，請造訪python.org並下載最新版本。安裝完成後，您可以在命令行或終端中輸入python --version來進行驗證。

IronPDF 安裝

IronPDF 是一個提供廣泛 PDF 操作功能的 PDF 函式庫。要安裝IronPDF，請打開命令行或終端並運行以下命令：

pip install ironpdf

IronPDF 的基本操作

要開始使用 IronPDF 來為 PDF 文件添加浮水印，基本操作包括設置環境、加載 PDF 文件、應用浮水印及保存加了浮水印的文件。以下是一個分步的代碼解析：

設置和配置

首先，匯入 IronPDF 函式庫並配置您的環境：

from ironpdf import *

# Insert your IronPDF license key
License.LicenseKey = "Your-License-Key"
# Enable debugging and set a log file path
Logger.EnableDebugging = True
Logger.LogFilePath = "Custom.log"
Logger.LoggingMode = Logger.LoggingModes.All

py

PYTHON

此部分將導入IronPDF，添加您的許可證密鑰，並配置日誌記錄以用於調試目的。

加載 PDF 文件

接下來，載入您要添加浮水印的 PDF 檔案：

# Create a ChromePdfRenderer instance
renderer = ChromePdfRenderer()
# Load the PDF file
pdf = PdfDocument.FromFile("htmlstring.pdf")

py

PYTHON

此處的程式碼建立一個 ChromePdfRenderer 實例，並使用 PdfDocument.FromFile 方法來載入所需的 PDF 檔案。

應用浮水印

將您的 PDF 文件載入 IronPDF 後，下一個關鍵步驟就是將浮水印應用到輸入檔案。以下是操作方法：

# Apply a text watermark
pdf.ApplyWatermark("<h2 style='color:red'>This is Watermark</h2>", 70,
                   VerticalAlignment.Middle, HorizontalAlignment.Center)

py

PYTHON

理解程式碼

浮水印文字：浮水印的文字以 HTML 格式定義。此處，<h2 style='color:red'>This is Watermark</h2> 表示浮水印將以紅色顯示 "This is Watermark" 行。 h2 標籤使文本變大，類似於標題。

不透明度設置：代碼中的70表示浮水印的不透明度級別。不透明度值的範圍是從0到100，其中0表示完全透明，而100表示完全不透明。將透明度設置為70%可確保浮水印明顯可見，卻不會掩蓋PDF的底層內容。

定位浮水印：浮水印在頁面上的位置對其可見性和有效性至關重要。 VerticalAlignment.Middle 和 HorizontalAlignment.Center 確保浮水印在頁面上垂直和水平方向的中央位置。這個中央放置使浮水印在每頁上都顯著可見，而不妨礙文件的重要內容。

使用 IronPDF 將圖片浮水印應用於 PDF

除了文字浮水印之外，IronPDF 還允許您將圖片浮水印應用於 PDF 文件。這對於品牌推廣或當您想將徽標或特定圖形作為浮水印包括在內時特別有用。以下是您可以執行此操作的方法：

# Apply an image watermark
pdf.ApplyWatermark("<img src='path/to/your/image.png' style='width:100px;height:100px;'>", 30,
                   VerticalAlignment.Middle, HorizontalAlignment.Center)

py

PYTHON

將 path/to/your/image.png 替換為您希望用作水印的圖像文件的實際路徑。此路徑可以指向各種圖像格式，如 PNG、JPEG 等。

保存帶水印的 PDF

最後，將帶有浮水印的 PDF 保存為新的 PDF 文件：

# Save the watermarked PDF as a new file
pdf.SaveAs("Watermarked.pdf")

py

PYTHON

水印 PDF 已保存為 "Watermarked.PDF"，但您可以將其更改為任何所需的文件名稱。這是輸出文件。

如何在 Python 中為 PDF 文件加上浮水印，圖 1：輸出浮水印文件 Watermarked.pdf

輸出浮水印檔案 "Watermarked.pdf"

透過遵循上述步驟，您將能夠在 Python 程式中為 PDF 檔案加上浮水印。

進階浮水印技術

IronPDF 提供先進的浮水印技術，使浮水印處理過程更加可控。這些技術包括調整浮水印的不透明度、大小和位置。

自訂浮水印透明度

您可以調整浮水印的透明度，以達到細緻或顯著的效果。 ApplyWatermark 方法的第二個參數用於設定不透明度：

# Apply a watermark with 50% opacity
pdf.ApplyWatermark("Watermark Text", 50,
                   VerticalAlignment.Middle, HorizontalAlignment.Center)

py

PYTHON

這適用於具有50％透明度的浮水印。

定位浮水印

IronPDF 允許您將水印放置在頁面的任何位置：

# Apply a watermark at the bottom right
pdf.ApplyWatermark("Watermark Text", 30,
                   VerticalAlignment.Bottom, HorizontalAlignment.Right)

py

PYTHON

此代碼將浮水印放置於每頁的右下角。

批次處理多個 PDF 文件

高效處理多個 PDF 文件是一個常見的需求。 IronPDF可以處理一個文件夾中的PDF文件，為每個文件添加水印。這在處理需要統一浮水印的文件時特別有用，例如公司標誌或用於版權目的的特定文字浮水印。以下是您可以使用 IronPDF 實現的方法：

import os
from ironpdf import *

# Insert your IronPDF license key
License.LicenseKey = "Your-License-Key"
# Enable debugging and set a log file path
Logger.EnableDebugging = True
Logger.LogFilePath = "Custom.log"
Logger.LoggingMode = Logger.LoggingModes.All
# Folder Path containing PDF files
folder_path = "path/to/your/pdf/folder"
# Loop through each file in the folder
for file_name in os.listdir(folder_path):
    if file_name.endswith(".pdf"):
        file_path = os.path.join(folder_path, file_name)
        pdf = PdfDocument.FromFile(file_path)
        # Apply the watermark
        pdf.ApplyWatermark(
            "<h2 style='color:red'>SAMPLE</h2>",
            30,
            VerticalAlignment.Middle,
            HorizontalAlignment.Center,
        )
        # Save the watermarked PDF in the same folder
        pdf.SaveAs(os.path.join(folder_path, "Watermarked_" + file_name))