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

Jak dodać tekstowy znak wodny do pliku PDF?

Uzyj metody applyWatermark, aby przystemplowac tekst na kazdej stronie dokumentu PDF. Metoda akceptuje łańcuch HTML, więc możesz stylizować znak wodny za pomocą dowolnej właściwości CSS: rodzina czcionek, rozmiar, kolor, odstęp między literami czy cień tekstu. W przykładzie poniżej dokument oznaczono jako "Poufny" na czerwono, co obejmuje najczęstszy scenariusz ścieżki audytu i kontroli dostępu.

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

Wywolanie applyWatermark dodaje znak wodny na wszystkie strony w jednej operacji. Domyślnie znak wodny renderuje się z 50% przezroczystością i jest wyśrodkowany na każdej stronie. Aby aktywować wszystkie funkcje biblioteki, skonfiguruj swój klucz licencyjny IronPDF przed jakimikolwiek operacjami na PDF. HTML przekazany do applyWatermark przyjmuje dowolny prawidlowy element HTML, wiec mozna dodac

Jak dodać znak wodny z obrazkiem do PDF?

Znaki wodne obrazow dzialaja za pomoca tej samej metody applyWatermark, owijajac tag w ciagu 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");
    }
}

Wlasciwosci CSS w znaczniku kontroluja rozmiar, pozycje i przezroczystosc:

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

Sciezka obrazu musi byc dostepna z katalogu roboczego JVM podczas dzialania. Dla wdrozen serwerowych, nalezy uzywac sciezek absolutnych lub umieszczac obraz jako dane URI Base64 wewnatrz atrybutu src, aby uniknac problemow z rozwiazaniem sciezki.

Jakie formaty plików są obsługiwane w przypadku znaków wodnych na obrazach?

IronPDF obsługuje formaty PNG, JPEG, GIF, SVG i BMP w znakach wodnych. PNG z przezroczystym tłem daje najczystsze wyniki dla znaków wodnych z logo. Plik wyjsciowy image_watermark.pdf pokazuje obraz o szerokosci 100 pikseli, wycentrowany na kazdej stronie z domyslna przezroczystoscia 50%. Aby wydobyć obrazy z istniejącego PDF do użycia w innym znaku wodnym, zobacz przewodnik ekstrakcja obrazów z PDF.

---

Moją ulubioną biblioteką tego typu jest IronPDF. Umożliwia ona szybkie i efektywne manipulowanie plikami PDF. Posiada także wiele cennych funkcji, takich jak eksport do formatu PDF/A i cyfrowe podpisywanie dokumentów PDF.

Milan Jovanovic

Microsoft MVP

Zobacz studium przypadku

IronOCR pozwala nam oszczędzić 40 000 USD rocznie na ręcznym przetwarzaniu, jednocześnie zwiększając produktywność i uwalniając zasoby do zadań o wysokim wpływie. Gorąco polecam.

Brent Matzelle

Dyrektor technologiczny, OPYN

Zobacz studium przypadku

IronSuite odgrywa kluczową rolę w naszej działalności. Są to narzędzia zwiększające wydajność w całej firmie, w tym tworzenie planów pięter i poprawa zarządzania zapasami.

David Jones

Główny inżynier oprogramowania, Agorus Build

Zobacz studium przypadku

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

Metoda applyWatermark przyjmuje parametry przezroczystosci i wyrównania po ciagu 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. Enomy VerticalAlignment i HorizontalAlignment kontroluja, na ktory naroznik lub krawedz strony jest celowany 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 obsluguje wiekszosc potrzeb dotyczacych znakow wodnych, ale klasy TextStamper i ImageStamper oferuja programatyczna kontrole, gdy wymagane sa dokladne wspolrzedne pikselowe, celowanie w zakres stron lub dynamiczne generowanie tekstu. Obydwie klasy naleza do pakietu com.ironsoftware.ironpdf.stamp.

TextStamper przyjmuje wartosc lancucha i udostepnia wlasciwosci dla czcionki, rozmiaru czcionki, koloru czcionki, wyrówniania poziomego i pionowego oraz przezroczystosci. Obsługuje również rotację jako liczbę całkowitą (w stopniach). ImageStamper przyjmuje sciezke pliku lub array bajtow dla obrazu i udostepnia te same kontrolki wyrównania i przezroczystosci co TextStamper.

Kluczowa przewaga klas do stemplowania nad applyWatermark jest zdolnosc do celowania w konkretne strony. Przekaz liste numerow stron indeksowanych od zera do metody stamp, aby zastosowac znak wodny tylko do stron, które tego wymagaja, na przyklad stemplowanie tylko strony tytulowej raportu lub strony koncowej 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 indeksowanych od zera numerow stron, dajac precyzyjna kontrole nad tym, jakie strony otrzymuja znak wodny. Gdy lista stron nie jest dostarczona, stempel stosowany jest do wszystkich stron. To czyni TextStamper wlasciwym wyborem za kazdym razem, gdy twoja aplikacja generuje znaki wodne dynamicznie, takie jak osadzanie unikalnego identyfikatora transakcji, nazwy uzytkownika lub sygnatury czasowej na kazdym wygenerowanym PDF-ie.

Do przetwarzania wsadowego, takiego jak stemplowanie setek PDF-ow z unikalnymi znakami wodnymi specyficznymi dla klienta, zaladuj i przystempluj kazdy PdfDocument w petli, nastepnie zakończ wywolaniem saveAs przed nastepną iteracja. IronPDF przetwarza każdy dokument niezależnie, więc zużycie pamięci pozostaje ograniczone. Przewodnik znakowania PDF w Javie obejmuje szczególowo ImageStamper i dodatkowe opcje stemplowania, a dokumentacja IronPDF Java dostarcza pelna dokumentacje API.

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

Ten przewodnik obejmuje cztery podejscia do znakowania PDF-ow w IronPDF dla Java: proste znaki wodne tekstowe przez applyWatermark, znaki wodne obrazowe za pomoca tagow HTML , kontrola przezroczystosci i wyrównania przez parametry metody oraz programatyczne oznaczanie stemplem ze TextStamper i ImageStamper dla zaawansowanych przypadkow uzycia.

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