Comment appliquer des filigranes personnalisés aux PDF en Java

À quoi ressemble le texte en filigrane ?

Le fichier de sortie text_watermark.pdf affiche le mot " Confidential " en rouge, centré horizontalement et verticalement sur chaque page. L'opacité par défaut de 50% permet de garder le contenu du document lisible sous le filigrane. Pour les documents multi-pages, chaque page reçoit le même tampon sans qu'une boucle par page soit nécessaire.

Pour des techniques de rendu HTML plus approfondies applicables aux filigranes, consultez le tutorial HTML to PDF.

Comment puis-je ajouter un filigrane d'image à un PDF ?

Les filigranes d'image fonctionnent selon la même méthode applyWatermark en encapsulant une balise <img> dans la chaîne HTML. Les fichiers PNG avec des fonds transparents sont idéaux pour les filigranes de logo car la transparence est préservée lorsque l'image est composée sur la page PDF. Les formats JPEG, GIF, SVG et BMP sont également pris en charge.

//: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");
    }
}

Les propriétés CSS dans la balise <img> contrôlent la taille, la position et la transparence :

//: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);'/>";

Le chemin d'accès à l'image doit être accessible depuis le répertoire de travail de la JVM au moment de l'exécution. Pour les déploiements sur serveur, utilisez des chemins absolus ou intégrez l'image sous forme d'URI de données Base64 dans l'attribut src afin d'éviter les problèmes de résolution de chemin.

Quels sont les formats de fichiers pris en charge pour les filigranes d'image ?

IronPDF prend en charge les formats d'image PNG, JPEG, GIF, SVG et BMP dans les filigranes. Les PNG avec un fond transparent produisent les résultats les plus nets pour les filigranes de logo. Le fichier de sortie image_watermark.pdf affiche l'image avec une largeur de 100 pixels, centrée sur chaque page avec une opacité par défaut de 50 %. Pour extraire des images d'un PDF existant pour les utiliser dans un autre filigrane, consultez le guide sur l'extraction d'images à partir de PDF.

Comment contrôler l'opacité et l'alignement des filigranes ?

La méthode applyWatermark accepte des paramètres d'opacité et d'alignement après la chaîne HTML. L'opacité est un entier de 0 (totalement transparent) à 100 (totalement opaque). Les valeurs entre 20 et 40 fonctionnent bien pour la plupart des documents, permettant de garder le filigrane visible sans masquer le texte principal. Les énumérations VerticalAlignment et HorizontalAlignment déterminent le coin ou le bord de la page où le filigrane doit être placé.

//: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");
    }
}

La combinaison des trois paramètres optionnels offre neuf options de positionnement distinctes, une pour chaque intersection d'alignement vertical et horizontal. Pour les cas d'utilisation nécessitant des filigranes à plusieurs positions sur la même page, ou des filigranes appliqués uniquement à une plage de pages spécifique, les classes de tamponneuses offrent un contrôle plus fin. Consultez le guide des arrière-plans et avant-plans pour des techniques de composition en couches.

Quelles sont les options d'alignement disponibles ?

La méthode applyWatermark prend en charge les constantes d'alignement suivantes :

Alignement vertical (VerticalAlignment) :

• TOP - filigrane ancré au bord supérieur
• MIDDLE - filigrane centré verticalement
• BOTTOM - filigrane ancré au bord inférieur

Alignement horizontal (HorizontalAlignment) :

• LEFT - filigrane ancré au bord gauche
• CENTER - filigrane centré horizontalement
• RIGHT - filigrane ancré au bord droit

Associez n'importe quelle valeur verticale avec n'importe quelle valeur horizontale pour un contrôle précis. Pour les documents nécessitant plusieurs tampons qui se chevauchent, tels qu'un logo dans le coin supérieur droit et un avis de brouillon centré en diagonale, appliquez chaque tampon sous la forme d'un appel applyWatermark distinct. Pour les superpositions basées sur des annotations, consultez l'exemple d'annotations.

Comment appliquer des filigranes avancés avec TextStamper et ImageStamper ?

La méthode applyWatermark répond à la plupart des besoins en matière de filigranage, mais les classes TextStamper et ImageStamper offrent un contrôle programmatique lorsque des coordonnées pixel exactes, le ciblage d'une plage de pages ou la génération dynamique de texte sont requis. Les deux classes appartiennent au package com.ironsoftware.ironpdf.stamp.

TextStamper accepte une valeur de chaîne et expose des propriétés pour la police, la taille de police, la couleur de police, l'alignement horizontal et vertical, ainsi que l'opacité. Il prend également en charge la rotation sous forme d'entier (degrés). ImageStamper accepte un chemin d'accès au fichier ou un tableau d'octets pour l'image et propose les mêmes commandes d'alignement et d'opacité que TextStamper.

Le principal avantage des classes stamper par rapport à applyWatermark réside dans leur capacité à cibler des pages spécifiques. Transmettez une liste de numéros de page indexés à partir de zéro à la méthode stamp pour appliquer le filigrane uniquement aux pages qui en ont besoin, par exemple en l'apposant uniquement sur la page de garde d'un rapport ou sur la page d'approbation finale d'un contrat.

//: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");
    }
}

La méthode stamp accepte un List<Integer> de numéros de page indexés à partir de zéro, ce qui permet de contrôler précisément les pages sur lesquelles le filigrane doit apparaître. Lorsque aucune liste de pages n'est fournie, le tampon s'applique à toutes les pages. Cela fait de TextStamper le choix idéal lorsque votre application génère des filigranes de manière dynamique, par exemple en intégrant un identifiant de transaction unique, un nom d'utilisateur ou un horodatage sur chaque PDF généré.

Pour le traitement par lots, par exemple pour apposer des filigranes uniques spécifiques à chaque client sur des centaines de PDF, chargez et apposez chaque PdfDocument dans une boucle, puis appelez saveAs avant l'itération suivante. IronPDF traite chaque document indépendamment, de sorte que l'utilisation de la mémoire reste limitée. Le guide Java PDF Stamp couvre en détail ImageStamper et d'autres options d'estampillage, et la documentation IronPDF Java fournit la référence API complète.

Quelles sont les prochaines étapes pour le filigrane de PDF en Java ?

Ce guide a présenté quatre approches pour ajouter des filigranes aux PDF avec IronPDF for Java : des filigranes textuels simples via applyWatermark, des filigranes d'image utilisant les balises HTML <img>, le contrôle de l'opacité et de l'alignement via les paramètres de méthode, et l'apposition programmatique avec TextStamper et ImageStamper pour les cas d'utilisation avancés.

Commencez votre essai gratuit pour tester le filigrane dans votre application Java. L'essai comprend un accès complet à toutes les fonctionnalités de tamponnage et de filigranage sans limite de temps pour l'évaluation. Lorsque vous êtes prêt à déployer, consultez les options de licence pour trouver le niveau qui correspond à votre utilisation.

Prêt à voir ce que vous pouvez faire d'autre? Consultez la page de tutoriels complète ici : Guides How-To IronPDF for Java