Como Aplicar Marcas d'água Personalizadas a PDFs em Java

Como faço para adicionar uma marca d'água de texto a um PDF?

Use o método applyWatermark para carimbar texto em cada página de um documento PDF. O método aceita uma string HTML, assim você pode estilizar a marca d'água com qualquer propriedade CSS: família de fontes, tamanho, cor, espaçamento entre letras ou sombra de texto. O exemplo abaixo marca um documento como "Confidencial" em vermelho, que cobre o cenário de trilha de auditoria e controle de acesso mais comum.

//:path=/static-assets/pdf/content-code-examples/how-to/custom-watermark/text-watermark.java
import java.io.IOException;
import java.nio.file.Paths;

import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;

public class Main {
    public static void main(String[] args) throws IOException {
        // Set the license key for IronPDF
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Load an existing PDF document from file
        PdfDocument pdf = PdfDocument.fromFile(Paths.get("sample.pdf"));

        // HTML string defines the watermark appearance via CSS
        String watermarkHtml = "<h1 style='color:red;'>Confidential</h1>";

        // Apply the watermark to every page
        pdf.applyWatermark(watermarkHtml);

        // Save the watermarked PDF to a new file
        pdf.saveAs("text_watermark.pdf");
    }
}

//:path=/static-assets/pdf/content-code-examples/how-to/custom-watermark/text-watermark.java
import java.io.IOException;
import java.nio.file.Paths;

import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;

public class Main {
    public static void main(String[] args) throws IOException {
        // Set the license key for IronPDF
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Load an existing PDF document from file
        PdfDocument pdf = PdfDocument.fromFile(Paths.get("sample.pdf"));

        // HTML string defines the watermark appearance via CSS
        String watermarkHtml = "<h1 style='color:red;'>Confidential</h1>";

        // Apply the watermark to every page
        pdf.applyWatermark(watermarkHtml);

        // Save the watermarked PDF to a new file
        pdf.saveAs("text_watermark.pdf");
    }
}

A chamada applyWatermark adiciona a marca-d'água a todas as páginas em uma única operação. Por padrão, a marca d'água é renderizada com opacidade de 50% e é centralizada em cada página. Para ativar todos os recursos da biblioteca, configure sua chave de licença IronPDF antes de qualquer operação de PDF. O HTML passado para applyWatermark aceita qualquer elemento HTML válido, para que você possa incluir

Como Posso Adicionar uma Marca d'água de Imagem a um PDF?

As marcas-d'água de imagem funcionam através do mesmo método applyWatermark envolvendo uma tag na string HTML. Arquivos PNG com fundos transparentes são ideais para marcas d'água de logotipo porque a transparência é preservada quando a imagem é composta na página do PDF. Formatos JPEG, GIF, SVG e BMP também são suportados.

//:path=/static-assets/pdf/content-code-examples/how-to/custom-watermark/image-watermark.java
import java.io.IOException;
import java.nio.file.Paths;

import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;

public class Main {
    public static void main(String[] args) throws IOException {
        // Set the license key for IronPDF
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Load an existing PDF document from file
        PdfDocument pdf = PdfDocument.fromFile(Paths.get("sample.pdf"));

        // Reference the image file path relative to the runtime working directory
        String watermarkHtml = "<img src='logo.png' style='width:100px;'/>";

        // Apply the image watermark to all pages
        pdf.applyWatermark(watermarkHtml);

        // Save the result
        pdf.saveAs("image_watermark.pdf");
    }
}

//:path=/static-assets/pdf/content-code-examples/how-to/custom-watermark/image-watermark.java
import java.io.IOException;
import java.nio.file.Paths;

import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;

public class Main {
    public static void main(String[] args) throws IOException {
        // Set the license key for IronPDF
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Load an existing PDF document from file
        PdfDocument pdf = PdfDocument.fromFile(Paths.get("sample.pdf"));

        // Reference the image file path relative to the runtime working directory
        String watermarkHtml = "<img src='logo.png' style='width:100px;'/>";

        // Apply the image watermark to all pages
        pdf.applyWatermark(watermarkHtml);

        // Save the result
        pdf.saveAs("image_watermark.pdf");
    }
}

As propriedades CSS na tag controlam o tamanho, posição e transparência:

//:path=/static-assets/pdf/content-code-examples/how-to/custom-watermark/image-watermark-advanced.java
// Apply a 150px logo at 50% opacity, rotated 45 degrees counterclockwise
String advancedWatermarkHtml =
    "<img src='logo.png' style='width:150px; opacity:0.5; transform:rotate(-45deg);'/>";

//:path=/static-assets/pdf/content-code-examples/how-to/custom-watermark/image-watermark-advanced.java
// Apply a 150px logo at 50% opacity, rotated 45 degrees counterclockwise
String advancedWatermarkHtml =
    "<img src='logo.png' style='width:150px; opacity:0.5; transform:rotate(-45deg);'/>";

O caminho da imagem deve ser acessível a partir do diretório de trabalho da JVM em tempo de execução. Para implantações de servidor, use caminhos absolutos ou incorpore a imagem como um URI de dados Base64 dentro do atributo src para evitar problemas de resolução de caminho.

Quais formatos de arquivo são suportados para marcas d'água em imagens?

IronPDF suporta formatos de imagem PNG, JPEG, GIF, SVG e BMP em marcas d'água. PNG com fundo transparente produz os resultados mais limpos para marcas d'água de logotipo. O arquivo de saída image_watermark.pdf mostra a imagem com largura de 100 pixels, centralizada em cada página com 50% de opacidade padrão. Para extrair imagens de um PDF existente para uso em outra marca d'água, veja o guia sobre extração de imagens de PDFs.

---

Minha biblioteca favorita desse tipo é o IronPDF. Ele permite a manipulação rápida e eficiente de arquivos PDF. Além disso, possui muitos recursos valiosos, como a exportação para o formato PDF/A e a assinatura digital de documentos PDF.

Milan Jovanovic

Microsoft MVP

Veja o estudo de caso

Com o IronOCR, podemos economizar US$ 40.000 por ano em processamento manual, ao mesmo tempo que aumentamos a produtividade e liberamos recursos para tarefas de alto impacto. Eu o recomendo fortemente.

Brent Matzelle

Diretor de Tecnologia, OPYN

Veja o estudo de caso

O IronSuite desempenha um papel crucial nas nossas operações. Estas são ferramentas que aumentam a eficiência no negócio, incluindo a criação de plantas baixas e melhoria na gestão de inventário.

David Jones

Engenheiro(a) de Software Líder, Agorus Build

Veja o estudo de caso

Como Controlo a Opacidade e Alinhamento da Marca d'água?

O método applyWatermark aceita parâmetros de opacidade e alinhamento após a string HTML. Opacidade é um inteiro de 0 (totalmente transparente) a 100 (totalmente opaco). Valores entre 20 e 40 funcionam bem para a maioria dos documentos, mantendo a marca d'água visível sem obscurecer o texto do corpo. Os enums VerticalAlignment e HorizontalAlignment controlam qual canto ou borda da página a marca-d'água tem como alvo.

//:path=/static-assets/pdf/content-code-examples/how-to/custom-watermark/watermark-opacity-alignment.java
import java.io.IOException;
import java.nio.file.Paths;

import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.stamp.HorizontalAlignment;
import com.ironsoftware.ironpdf.stamp.VerticalAlignment;

public class Main {
    public static void main(String[] args) throws IOException {
        // Set the license key for IronPDF
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Load an existing PDF document from file
        PdfDocument pdf = PdfDocument.fromFile(Paths.get("sample.pdf"));

        // Define the watermark HTML
        String watermarkHtml = "<h1 style='color:blue;'>Confidential</h1>";

        // Apply at 30% opacity, anchored to the top-left corner of each page
        pdf.applyWatermark(watermarkHtml, 30, VerticalAlignment.TOP, HorizontalAlignment.LEFT);

        // Save the result
        pdf.saveAs("watermark_opacity_alignment.pdf");
    }
}

//:path=/static-assets/pdf/content-code-examples/how-to/custom-watermark/watermark-opacity-alignment.java
import java.io.IOException;
import java.nio.file.Paths;

import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.stamp.HorizontalAlignment;
import com.ironsoftware.ironpdf.stamp.VerticalAlignment;

public class Main {
    public static void main(String[] args) throws IOException {
        // Set the license key for IronPDF
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Load an existing PDF document from file
        PdfDocument pdf = PdfDocument.fromFile(Paths.get("sample.pdf"));

        // Define the watermark HTML
        String watermarkHtml = "<h1 style='color:blue;'>Confidential</h1>";

        // Apply at 30% opacity, anchored to the top-left corner of each page
        pdf.applyWatermark(watermarkHtml, 30, VerticalAlignment.TOP, HorizontalAlignment.LEFT);

        // Save the result
        pdf.saveAs("watermark_opacity_alignment.pdf");
    }
}

Combinando os três parâmetros opcionais, obtém-se nove opções distintas de posicionamento, uma para cada interseção de alinhamento vertical e horizontal. Para casos de uso que exigem marcas d'água em múltiplas posições na mesma página, ou marcas d'água aplicadas apenas a um intervalo específico de páginas, as classes stamper oferecem controle mais fino. Veja o guia de fundos e frentes para técnicas de composição em camadas.

Como Aplico Marcas d'água Avançadas com TextStamper e ImageStamper?

O método applyWatermark atende à maioria das necessidades de marca d'água, mas as classes TextStamper e ImageStamper oferecem controle programático quando são necessárias coordenadas de pixel exatas, segmentação de intervalo de páginas ou geração dinâmica de texto. Ambas as classes pertencem ao pacote com.ironsoftware.ironpdf.stamp.

TextStamper aceita um valor string e expõe propriedades para fonte, tamanho da fonte, cor da fonte, alinhamento horizontal e vertical, e opacidade. Também suporta rotação como um inteiro (graus). ImageStamper aceita um caminho de arquivo ou array de bytes para a imagem e expõe os mesmos controles de alinhamento e opacidade que TextStamper.

A principal vantagem das classes de carimbador sobre applyWatermark é a capacidade de segmentar páginas específicas. Passe uma lista de números de página com índice-zero para o método stamp para aplicar a marca d'água apenas às páginas que precisam dela, por exemplo, estampando apenas a página de capa de um relatório ou a página de aprovação final de um contrato.

//:path=/static-assets/pdf/content-code-examples/how-to/custom-watermark/text-stamper.java
import java.io.IOException;
import java.nio.file.Paths;
import java.util.Arrays;

import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.stamp.HorizontalAlignment;
import com.ironsoftware.ironpdf.stamp.TextStamper;
import com.ironsoftware.ironpdf.stamp.VerticalAlignment;

public class Main {
    public static void main(String[] args) throws IOException {
        // Set the license key for IronPDF
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Load the target PDF document
        PdfDocument pdf = PdfDocument.fromFile(Paths.get("sample.pdf"));

        // Configure a TextStamper with custom font, rotation, and opacity
        TextStamper stamper = new TextStamper();
        stamper.setText("DRAFT");
        stamper.setFontSize(72);
        stamper.setFontColor("gray");
        stamper.setOpacity(40);
        stamper.setRotation(45);
        stamper.setVerticalAlignment(VerticalAlignment.MIDDLE);
        stamper.setHorizontalAlignment(HorizontalAlignment.CENTER);

        // Apply the stamp only to pages 0 and 1 (zero-indexed)
        pdf.stamp(stamper, Arrays.asList(0, 1));

        // Save the stamped PDF
        pdf.saveAs("text_stamped.pdf");
    }
}

//:path=/static-assets/pdf/content-code-examples/how-to/custom-watermark/text-stamper.java
import java.io.IOException;
import java.nio.file.Paths;
import java.util.Arrays;

import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.stamp.HorizontalAlignment;
import com.ironsoftware.ironpdf.stamp.TextStamper;
import com.ironsoftware.ironpdf.stamp.VerticalAlignment;

public class Main {
    public static void main(String[] args) throws IOException {
        // Set the license key for IronPDF
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Load the target PDF document
        PdfDocument pdf = PdfDocument.fromFile(Paths.get("sample.pdf"));

        // Configure a TextStamper with custom font, rotation, and opacity
        TextStamper stamper = new TextStamper();
        stamper.setText("DRAFT");
        stamper.setFontSize(72);
        stamper.setFontColor("gray");
        stamper.setOpacity(40);
        stamper.setRotation(45);
        stamper.setVerticalAlignment(VerticalAlignment.MIDDLE);
        stamper.setHorizontalAlignment(HorizontalAlignment.CENTER);

        // Apply the stamp only to pages 0 and 1 (zero-indexed)
        pdf.stamp(stamper, Arrays.asList(0, 1));

        // Save the stamped PDF
        pdf.saveAs("text_stamped.pdf");
    }
}

O método stamp aceita um List de números de página com índice-zero, oferecendo controle preciso sobre quais páginas recebem a marca d'água. Quando nenhuma lista de páginas é fornecida, o carimbo é aplicado a todas as páginas. Isso torna TextStamper a escolha certa sempre que sua aplicação gera marcas d'água dinamicamente, como inserir um ID de transação único, nome de usuário ou carimbo de data/hora em cada PDF gerado.

Para processamento em lote, como estampar centenas de PDFs com marcas d'água exclusivas específicas do cliente, carregue e estampe cada PdfDocument em um loop, em seguida, chame saveAs antes da próxima iteração. IronPDF processa cada documento de forma independente, então o uso de memória permanece limitado. O guia de carimbo PDF Java cobre ImageStamper e opções adicionais de carimbo em detalhes, e a documentação IronPDF Java fornece a referência completa da API.

Quais São os Próximos Passos para Marcação de Água no PDF em Java?

Este guia cobriu quatro abordagens para colocar marcas d'água em PDFs com IronPDF for Java: marcas d'água de texto simples via applyWatermark, marcas d'água de imagem usando tags HTML , controle de opacidade e alinhamento por meio de parâmetros de método, e estampagem programática com TextStamper e ImageStamper para casos de uso avançados.

Inicie sua avaliação gratuita para testar a marcação em sua aplicação Java. A avaliação inclui acesso completo a todos os recursos de marcação e marca d'água sem limite de tempo na avaliação. Quando estiver pronto para implantar, veja opções de licenciamento para encontrar o nível que se adapta ao seu uso.

Pronto para ver o que mais você pode fazer? Confira a página completa do tutorial aqui: Guias de Como Fazer IronPDF for Java