Jak zastosować niestandardowe znaki wodne do PDFów w Java

Jak wygląda znak wodny w tekście?

Plik wyjściowy text_watermark.pdf zawiera słowo "Confidential" (Poufne) w kolorze czerwonym, wyśrodkowane poziomo i pionowo na każdej stronie. Domyślna przezroczystość 50% utrzymuje czytelność treści dokumentu pod znakiem wodnym. Dla dokumentów wielostronicowych każda strona otrzymuje ten sam stempel bez potrzeby pętli po stronach.

Dla głębszych technik renderowania HTML, które mają zastosowanie do znaków wodnych, zobacz samouczek konwersji HTML do PDF.

Jak dodać znak wodny z obrazkiem do PDF?

Znak wodny na obrazie działa na tej samej zasadzie applyWatermark poprzez umieszczenie tagu <img> w ciągu HTML. Pliki PNG z przezroczystym tłem są idealne do znaków wodnych z logo, ponieważ przezroczystość jest zachowana, gdy obraz jest łączony ze stroną PDF. Formaty JPEG, GIF, SVG i BMP również są obsługiwane.

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

Właściwości CSS w tagu <img> kontrolują rozmiar, położenie i przezroczystość:

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

Ścieżka do obrazu musi być dostępna z katalogu roboczego JVM w czasie wykonywania. W przypadku wdrożeń serwerowych należy używać ścieżek bezwzględnych lub osadzić obraz jako URI danych Base64 wewnątrz atrybutu src, aby uniknąć problemów z rozpoznawaniem ścieżek.

Jak kontrolować przezroczystość i wyrównanie znaku wodnego?

Metoda applyWatermark akceptuje parametry krycia i wyrównania po ciągu HTML. Przezroczystość to liczba całkowita od 0 (całkowicie przezroczysty) do 100 (całkowicie nieprzezroczysty). Wartości między 20 a 40 dobrze sprawdzają się w większości dokumentów, utrzymując widoczność znaku wodnego bez zasłaniania tekstu głównego. Enumy VerticalAlignment i HorizontalAlignment kontrolują, w którym rogu lub na której krawędzi strony ma się znajdować znak wodny.

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

Połączenie trzech opcjonalnych parametrów daje dziewięć różnych opcji pozycjonowania, po jednej dla każdego przecięcia wyrównania pionowego i poziomego. W przypadkach użycia, które wymagają znaków wodnych w wielu pozycjach na tej samej stronie lub znaków wodnych stosowanych tylko do określonego zakresu stron, klasy stemplarza zapewniają dokładniejszą kontrolę. Zobacz przewodnik w tle i pierwszym planie dla technik kompozycji warstwowej.

Jak stosować zaawansowane znaki wodne z TextStamper i ImageStamper?

Metoda applyWatermark obsługuje większość potrzeb związanych z znakami wodnymi, ale klasy TextStamper i ImageStamper oferują kontrolę programową, gdy wymagane są dokładne współrzędne pikseli, kierowanie na zakres stron lub dynamiczne generowanie tekstu. Obie klasy należą do pakietu com.ironsoftware.ironpdf.stamp.

TextStamper przyjmuje wartość ciągu znaków i udostępnia właściwości dotyczące czcionki, rozmiaru czcionki, koloru czcionki, wyrównania poziomego i pionowego oraz krycia. Obsługuje również rotację jako liczbę całkowitą (w stopniach). ImageStamper akceptuje ścieżkę do pliku lub tablicę bajtów dla obrazu i udostępnia te same opcje wyrównania i krycia, co TextStamper.

Główną zaletą klas stamper w porównaniu z applyWatermark jest możliwość kierowania działań na konkretne strony. Przekaż listę numerów stron indeksowanych od zera do metody stamp, aby zastosować znak wodny tylko na tych stronach, które tego wymagają, na przykład umieszczając go tylko na stronie tytułowej raportu lub na stronie ostatecznego zatwierdzenia umowy.

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

Metoda stamp przyjmuje List<Integer> indeksowanych od zera numerów stron, co daje precyzyjną kontrolę nad tym, które strony otrzymają znak wodny. Gdy lista stron nie jest dostarczona, stempel stosowany jest do wszystkich stron. To sprawia, że TextStamper jest właściwym wyborem zawsze, gdy aplikacja generuje znaki wodne dynamicznie, np. osadzając unikalny identyfikator transakcji, nazwę użytkownika lub znacznik czasu w każdym wygenerowanym pliku PDF.

W przypadku przetwarzania wsadowego, takiego jak stemplowanie setek plików PDF unikalnymi znakami wodnymi dostosowanymi do potrzeb klienta, należy załadować i ostemplować każdy PdfDocument w pętli, a następnie wywołać saveAs przed kolejną iteracją. IronPDF przetwarza każdy dokument niezależnie, więc zużycie pamięci pozostaje ograniczone. Przewodnik po stemplach Java PDF szczegółowo omawia ImageStamper oraz dodatkowe opcje stemplowania, a dokumentacja IronPDF Java zawiera kompletną Dokumentację API.

Jakie są kolejne kroki w znakowaniu wodnym PDF w Java?

W niniejszym przewodniku omówiono cztery podejścia do znakowania wodnego plików PDF za pomocą IronPDF for Java: proste znaki wodne tekstowe za pomocą applyWatermark, znaki wodne graficzne przy użyciu tagów HTML <img>, kontrolę krycia i wyrównania za pomocą parametrów metod oraz programowe nanoszenie znaków za pomocą TextStamper i ImageStamper w zaawansowanych przypadkach użycia.

Rozpocznij darmowy okres próbny, aby przetestować znakowanie wodne w swojej aplikacji Java. Okres próbny oferuje pełny dostęp do wszystkich funkcji stemplowania i znakowania wodnego bez limitu czasowego na ocenę. Gdy będziesz gotowy do wdrożenia, zapoznaj się z opcjami licencyjnymi, aby znaleźć poziom, który pasuje do Twojego użycia.

Gotowy, aby sprawdzić, co jeszcze możesz zrobić? Sprawdź pełną stronę przewodnika tutaj: IronPDF for Java How-To Guides