Como adicionar uma marca d'água a um arquivo PDF em Python

Instalação do Python

Python é uma linguagem de programação poderosa e fácil de usar. Se você ainda não instalou o Python, visite python.org e baixe a versão mais recente. Após a instalação, você pode verificá-la digitando python --version na linha de comando ou terminal.

Instalação do IronPDF

IronPDF é uma biblioteca PDF que oferece uma ampla gama de funcionalidades para manipulação de PDFs. Para instalar o IronPDF, abra a linha de comando ou o terminal e execute o seguinte comando:

pip install ironpdf

Configuração e instalação

Primeiro, importe a biblioteca IronPDF e configure seu ambiente:

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

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

Esta seção importará o IronPDF, adicionará sua chave de licença e configurará o registro de logs para fins de depuração.

Carregando o arquivo PDF

Em seguida, carregue o arquivo PDF ao qual deseja adicionar a marca d'água:

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

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

O código aqui cria uma instância de ChromePdfRenderer e usa o método PdfDocument.FromFile para carregar o arquivo PDF desejado.

Aplicando a marca d'água

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

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

Aplicando uma marca d'água de imagem a um PDF com o IronPDF

Além de marcas d'água de texto , o IronPDF permite aplicar marcas d'água de imagem aos seus documentos PDF. Isso é particularmente útil para fins de branding ou quando você deseja incluir um logotipo ou um gráfico específico como marca d'água. Eis como você pode fazer isso:

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

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

Substitua path/to/your/image.png pelo caminho real do arquivo de imagem que você deseja usar como marca d'água. Este caminho pode apontar para vários formatos de imagem, como PNG, JPEG, etc.

Salvando o PDF com marca d'água

Por fim, salve o PDF com marca d'água como um novo arquivo PDF:

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

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

O PDF com marca d'água é salvo como "Watermarked.pdf", mas você pode alterar esse nome para qualquer nome de arquivo desejado. Aqui está o arquivo de saída.

Arquivo de marca d'água de saída "Watermarked.pdf"

Seguindo os passos acima, você poderá adicionar marcas d'água a arquivos PDF em um programa Python.

Personalizando a opacidade da marca d'água

Você pode ajustar a opacidade da marca d'água para torná-la mais sutil ou mais visível. O segundo parâmetro do método ApplyWatermark serve para definir a opacidade:

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

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

Isso aplica uma marca d'água com 50% de opacidade.

Posicionando a marca d'água

O IronPDF permite posicionar sua marca d'água em qualquer lugar da página:

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

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

Este código posiciona a marca d'água no canto inferior direito de cada página.

Processamento em lote de vários arquivos PDF

Lidar com vários arquivos PDF de forma eficiente é uma necessidade comum. O IronPDF pode processar uma pasta de arquivos PDF, aplicando marcas d'água a cada um deles. Isso é particularmente útil ao lidar com documentos que exigem uma marca d'água uniforme, como o logotipo de uma empresa ou uma marca d'água de texto específica para fins de direitos autorais. Veja como você pode fazer isso com o 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))

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))

Este exemplo de código percorre todos os arquivos PDF em uma pasta especificada, aplica a marca d'água a cada um deles e os salva com um novo nome.

Opções de economia

O IronPDF oferece diversas opções de salvamento. Você pode sobrescrever o arquivo existente ou salvar o PDF com marca d'água como um novo arquivo. Além disso, você pode especificar o caminho do arquivo de saída para organizar melhor seus documentos.

Otimizando o tamanho do arquivo de saída

Arquivos PDF grandes com imagens de alta resolução ou conteúdo extenso podem ficar bastante volumosos. O IronPDF oferece opções para otimizar o arquivo de saída, reduzindo seu tamanho sem afetar significativamente a qualidade. Você pode usar o método de compressão de PDF do IronPDF para essa tarefa. Isso é particularmente importante ao compartilhar documentos por e-mail ou ao carregá-los em plataformas online.