Wie man benutzerdefinierte Wasserzeichen zu PDFs in Java hinzufügt

Wie wende ich ein Textwasserzeichen auf eine PDF-Datei an?

Verwenden Sie die Methode applyWatermark, um Text auf jede Seite eines PDF-Dokuments zu stempeln. Die Methode akzeptiert einen HTML-String, sodass Sie das Wasserzeichen mit jeder CSS-Eigenschaft stylen können: Schriftfamilie, Größe, Farbe, Zeichenabstand oder Textschatten. Das unten stehende Beispiel kennzeichnet ein Dokument als 'Vertraulich' in Rot, was das häufigste Audit-Trail- und Zugriffskontrollszenario abdeckt.

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

Der applyWatermark-Aufruf fügt das Wasserzeichen in einem einzigen Vorgang zu allen Seiten hinzu. Standardmäßig wird das Wasserzeichen mit 50 % Opazität gerendert und ist auf jeder Seite zentriert. Um alle Funktionen der Bibliothek zu aktivieren, konfigurieren Sie Ihren IronPDF-Lizenzschlüssel, bevor Sie irgendwelche PDF-Operationen ausführen. Das an applyWatermark übergebene HTML akzeptiert jedes gültige HTML-Element, sodass Sie <div>, <span> oder formatierte <p>-Tags für mehrzeilige Wasserzeichen einfügen können.

Wie füge ich ein Bild-Wasserzeichen zu einem PDF hinzu?

Bildwasserzeichen funktionieren über die gleiche applyWatermark-Methode, indem Sie ein <img>-Tag im HTML-String einfügen. PNG-Dateien mit transparenten Hintergründen sind ideal für Logo-Wasserzeichen, da die Transparenz erhalten bleibt, wenn das Bild auf die PDF-Seite zusammengesetzt wird. JPEG-, GIF-, SVG- und BMP-Formate werden ebenfalls unterstützt.

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

CSS-Eigenschaften im <img>-Tag steuern Größe, Position und Transparenz:

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

Der Bildpfad muss zur Laufzeit vom Arbeitsverzeichnis der JVM aus zugänglich sein. Für Server-Einsätze verwenden Sie absolute Pfade oder betten das Bild als Base64-Daten-URI im src-Attribut ein, um Pfadauflösungsprobleme zu vermeiden.

Welche Dateiformate werden für Bildwasserzeichen unterstützt?

IronPDF unterstützt PNG-, JPEG-, GIF-, SVG- und BMP-Bildformate in Wasserzeichen. PNG mit einem transparenten Hintergrund ergibt die saubersten Ergebnisse für Logo-Wasserzeichen. Die Ausgabedatei image_watermark.pdf zeigt das Bild mit einer Breite von 100 Pixeln, zentriert auf jeder Seite bei 50 % Standardopazität. Um Bilder aus einem vorhandenen PDF zur Verwendung in einem anderen Wasserzeichen zu extrahieren, siehe den Leitfaden zu Bilder aus PDFs extrahieren.

---

Meine Lieblingsbibliothek dieser Art ist IronPDF. Es ermöglicht eine schnelle und effiziente Bearbeitung von PDF-Dateien. Es verfügt auch über viele wertvolle Funktionen, wie das Exportieren in das PDF/A-Format und das digitale Signieren von PDF-Dokumenten.

Milan Jovanovic

Microsoft MVP

Fallstudie ansehen

IronOCR bedeutet, dass wir jährlich 40.000 $ durch manuelle Verarbeitung einsparen können, während die Produktivität gesteigert wird und Ressourcen für wichtige Aufgaben freigesetzt werden. Ich würde es sehr empfehlen.

Brent Matzelle

Technischer Leiter, OPYN

Fallstudie ansehen

Die Iron Suite spielt eine entscheidende Rolle in unseren Operationen. Diese Werkzeuge erhöhen die Effizienz im gesamten Unternehmen, einschließlich der Erstellung von Grundrissen und der Verbesserung des Bestandsmanagements.

David Jones

Leitender Software-Ingenieur, Agorus Build

Fallstudie ansehen

Wie steuere ich die Opazität und Ausrichtung von Wasserzeichen?

Die Methode applyWatermark akzeptiert Opazität- und Ausrichtungsparameter nach dem HTML-String. Opazität ist eine Ganzzahl von 0 (vollständig transparent) bis 100 (vollständig undurchsichtig). Werte zwischen 20 und 40 sind für die meisten Dokumente geeignet, um das Wasserzeichen sichtbar zu halten, ohne den Haupttext zu verdecken. Die VerticalAlignment und HorizontalAlignment-Enums steuern, welche Ecke oder Kante der Seite das Wasserzeichen anvisiert.

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

Das Kombinieren der drei optionalen Parameter ergibt neun unterschiedliche Positionierungsoptionen, eine für jedes Kreuzungspunkt von vertikaler und horizontaler Ausrichtung. Für Anwendungsfälle, die Wasserzeichen an mehreren Positionen auf derselben Seite erfordern oder Wasserzeichen, die nur auf einen bestimmten Seitenbereich angewendet werden, bieten die Stamper-Klassen eine feinere Kontrolle. Siehe den Hintergründe und Vordergründe Leitfaden für Techniken der Schichtkomposition.

Wie wende ich erweiterte Wasserzeichen mit TextStamper und ImageStamper an?

Die Methode applyWatermark deckt die meisten Wasserzeichenbedürfnisse ab, aber die Klassen TextStamper und ImageStamper bieten programmgesteuerte Kontrolle, wenn exakte Pixelkoordinaten, Zielseitenbereiche oder dynamische Textgenerierung erforderlich sind. Beide Klassen gehören zum com.ironsoftware.ironpdf.stamp-Paket.

TextStamper akzeptiert ein Zeichenfolgenwert und stellt Eigenschaften für Schriftart, Schriftgröße, Schriftfarbe, horizontale und vertikale Ausrichtung sowie Opazität bereit. Es unterstützt auch Drehung als Ganzzahl (Grad). ImageStamper akzeptiert einen Dateipfad oder ein Byte-Array für das Bild und bietet die gleichen Ausrichtungs- und Opazitätskontrollen wie TextStamper.

Der entscheidende Vorteil der Stempelerklassen über applyWatermark ist die Fähigkeit, bestimmte Seiten zu zielen. Geben Sie eine Liste von nullbasierten Seitennummern an die stamp-Methode weiter, um das Wasserzeichen nur auf die Seiten anzuwenden, die es benötigen, zum Beispiel nur die Titelseite eines Berichts zu stempeln oder die endgültige Genehmigungsseite eines Vertrags.

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

Die Methode stamp akzeptiert eine List<Integer> von nullbasierten Seitennummern, was eine präzise Steuerung darüber ermöglicht, welche Seiten das Wasserzeichen erhalten. Wenn keine Seitenliste bereitgestellt wird, wird der Stempel auf alle Seiten angewendet. Dies macht TextStamper zur richtigen Wahl immer dann, wenn Ihre Anwendung Wasserzeichen dynamisch generiert, wie das Einbetten einer eindeutigen Transaktions-ID, eines Benutzernamen oder eines Zeitstempels auf jedem generierten PDF.

Für die Stapelverarbeitung, wie das Stempeln von Hunderten von PDFs mit einzigartigen kundenspezifischen Wasserzeichen, laden und stempeln Sie jedes PdfDocument in einer Schleife und rufen dann saveAs vor der nächsten Iteration auf. IronPDF verarbeitet jedes Dokument unabhängig, sodass die Speicherverwendung begrenzt bleibt. Der Java PDF Stempel-Leitfaden behandelt ImageStamper und zusätzliche Stempeloptionen im Detail, und die IronPDF Java Dokumentation bietet die gesamte API-Referenz.

Was sind die nächsten Schritte für PDF-Wasserzeichen in Java?

Dieser Leitfaden behandelte vier Ansätze zur Wasserzeichenerhaltung von PDFs mit IronPDF for Java: einfache Textwasserzeichen über applyWatermark, Bildwasserzeichen mit HTML-<img>-Tags, Opazitäts- und Ausrichtungssteuerung über Methodenparameter und programmgesteuertes Stempeln mit TextStamper und ImageStamper für fortgeschrittene Anwendungsfälle.

Starten Sie Ihre kostenlose Testversion, um Wasserzeichen in Ihrer Java-Anwendung zu testen. Die Testversion bietet vollständigen Zugriff auf alle Stempel- und Wasserzeichen-Funktionen ohne Zeitlimit für die Bewertung. Wenn Sie bereit sind, zu implementieren, sehen Sie sich die Lizenzierungsoptionen an um den Plan zu finden, der zu Ihrem Gebrauch passt.

Bereit zu sehen, was Sie sonst noch tun können? Sehen Sie sich die komplette Tutorialseite hier an: IronPDF for Java How-To Guides