Jak stosować niestandardowe znaki wodne w plikach PDF

This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPDF umożliwia stosowanie niestandardowych znaków wodnych w dokumentach PDF przy użyciu ciągów HTML z pełną obsługą CSS, co pozwala na pełną personalizację tekstu, obrazów, krycia, obrotu i pozycjonowania w celach brandingowych lub związanych z bezpieczeństwem.

Szybki start: Dodawanie znaków wodnych do plików PDF w Javie

  1. Zaimportuj bibliotekę IronPDF i ustaw swój klucz licencyjny
  2. Zaladuj swoj dokument PDF, uzywajac PdfDocument.fromFile()
  3. Utwórz ciąg HTML dla swojego znaku wodnego (tekst lub obraz)
  4. Zastosuj znak wodny, uzywajac pdf.applyWatermark(watermarkHtml)
  5. Zapisz PDF z znakiem wodnym przy pomocy pdf.saveAs()

```java :title=QuickStartWatermark.java PDFDocument pdf = PDFDocument.fromFile(Paths.get("sample.pdf")); pdf.applyWatermark(""); PDF.saveAs("watermarked.PDF");


Znak wodny chroni dokumenty PDF i potwierdza własność lub status poprzez oznaczenie ich jako "Poufne" lub umieszczenie na nich logo. IronPDF zapewnia elastyczne rozwiązanie wykorzystujące ciągi znaków HTML z pełną obsługą CSS. Umożliwia to pełną personalizację za pomocą standardowych właściwości HTML i CSS.

W niniejszym przewodniku przedstawiono różne typy znaków wodnych — tekstowe, graficzne, z regulacją położenia, krycia i obrotu — a także zaawansowane metody wykorzystujące [narzędzia TextStamper](https://ironpdf.com/java/object-reference/api/com/ironsoftware/ironpdf/stamp/TextStamper.html) i [ImageStamper](https://ironpdf.com/java/object-reference/api/com/ironsoftware/ironpdf/stamp/ImageStamper.html). Aby poznać więcej technik obróbki plików PDF, zapoznaj się z naszym przewodnikiem dotyczącym [tworzenia plików PDF](https://ironpdf.com/java/how-to/java-create-pdf-tutorial/) lub dowiedz się więcej o [dodawaniu tła i pierwszego planu](https://ironpdf.com/java/how-to/background-foreground/).

<div class="hsg-featured-snippet">
    <h2>Jak stosować znaki wodne w Javie</h2>
     <ol>
        <li><a class="js-modal-open" data-modal-id="download-modal" href="#download-modal">Pobierz bibliotekę Java, aby nakładać znaki wodne na pliki PDF</a></li>
        <li>Wygeneruj nowy plik PDF lub załaduj istniejący</li>
        <li>Skonfiguruj ciąg HTML lub obraz, który ma być używany jako znak wodny</li>
        <li>Zastosuj znak wodny przy użyciu odpowiedniej metody</li>
        <li>W razie potrzeby dostosuj parametry krycia, obrotu i położenia</li>
    </ol>
</div>

## Jak dodać tekstowy znak wodny do pliku PDF?

Aby zastosowac prosty tekstowy znak wodny do dokumentu PDF, uzyj metody `applyWatermark`. Ta metoda akceptuje tekst wykorzystujący HTML i CSS do zaawansowanego formatowania. Na przykład, dodaj do pliku PDF tekst "Poufne" w kolorze czerwonym. Technika ta oznacza dokumenty do użytku wewnętrznego lub wskazuje status poufności. Podejście oparte na HTML zapewnia elastyczność dzięki właściwościom CSS, w tym niestandardowym czcionkom, kolorom, rozmiarom i efektom tekstowym.

```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 for watermark
        String watermarkHtml = "<h1 style='color:red;'>Confidential</h1>";

        // Apply the watermark using HTML string
        pdf.applyWatermark(watermarkHtml);

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

Kod przedstawia podstawową implementację. Najpierw skonfiguruj licencję IronPDF, aby uzyskać dostęp do wszystkich funkcji. Znak wodny HTML akceptuje dowolne poprawne elementy HTML i style CSS, co zapewnia pełną kontrolę nad wyglądem.

Jak wygląda znak wodny w tekście?

Powstały plik PDF, "text_watermark.pdf", zawiera określony znak wodny na wszystkich stronach, a tekst "Poufne" jest wyświetlany na czerwono pośrodku dokumentu. Domyślnie znak wodny pojawia się z 50% kryciem, aby zachować czytelność przy jednoczesnym zapewnieniu widoczności.

W przypadku złożonego formatowania tekstu zapoznaj się z naszym przewodnikiem po konwersji HTML do PDF, który obejmuje zaawansowane techniki renderowania HTML mające zastosowanie do znaków wodnych.


Jak dodać obraz jako znak wodny?

Korzystając z tej samej metody, zastosuj obrazy jako znaki wodne, obsługując formaty takie jak PNG, JPEG, SVG i inne. Stylizuj i umieszczaj obrazy za pomocą CSS w ciągu HTML. Ta funkcja dodaje do dokumentów logo firmy, pieczęcie certyfikacyjne lub elementy związane z marką. Upewnij się, że obrazy są dostępne ze środowiska uruchomieniowego aplikacji.

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"));

        // Image HTML watermark
        String watermarkHtml = "<img src='logo.png' style='width:100px;'/>";

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

        // Save the PDF to a new file
        pdf.saveAs("image_watermark.pdf");
    }
}
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"));

        // Image HTML watermark
        String watermarkHtml = "<img src='logo.png' style='width:100px;'/>";

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

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

Użyj właściwości CSS do zaawansowanego stylizowania z wykorzystaniem znaków wodnych na obrazach:

// Example with more advanced CSS styling
String advancedWatermarkHtml = "<img src='logo.png' style='width:150px; opacity:0.5; transform:rotate(-45deg);'/>";
// Example with more advanced CSS styling
String advancedWatermarkHtml = "<img src='logo.png' style='width:150px; opacity:0.5; transform:rotate(-45deg);'/>";
JAVA

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

Powstały plik PDF, "image_watermark.pdf", zawiera obraz "logo.png" jako znak wodny na wszystkich stronach. Obraz wyświetla się w szerokości 100 pikseli. IronPDF obsługuje formaty, w tym PNG, JPEG, GIF, SVG i BMP. Do znaków wodnych w postaci logo należy używać obrazów PNG z przezroczystym tłem. Aby wyodrębnić obrazy z istniejących plików PDF, zapoznaj się z naszym przewodnikiem dotyczącym wyodrębniania obrazów z plików PDF.


Jak dostosować krycie i położenie znaku wodnego?

Dostosuj wygląd znaku wodnego, regulując jego przezroczystość i stosując obrót. Metoda applyWatermark akceptuje oba wlasciwosci jako parametry. Dostosuj te ustawienia, aby zapewnić widoczność znaku wodnego bez zasłaniania treści dokumentu. Przezroczystość waha się od 0 (przezroczyste) do 100 (nieprzezroczyste), przy czym optymalną równowagę zapewnia wartość 20–40.

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"));

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

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

        // Save the PDF to a new file
        pdf.saveAs("watermark_opacity_rotation.pdf");
    }
}
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"));

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

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

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

W przypadku złożonego pozycjonowania należy połączyć znaki wodne z innymi funkcjami stemplowania. Więcej informacji znajdziesz w naszym przewodniku dotyczącym tła i pierwszego planu.

Jakie opcje wyrównania są dostępne?

Metoda applyWatermark aplikuje znaki wodne oparte na HTML do wszystkich stron PDF z tymi opcjami:

  • Przezroczystosc: Zastosowano na 30% przezroczystosci dla czesciowej przezroczystosci
  • Wyrownywanie pionowe: Wyrownane do strony TOP. Opcje obejmują:
    • TOP: Znak wodny u góry strony
    • ŚRODEK: Znak wodny na środku strony
    • DÓŁ: Znak wodny na dole strony
  • Wyrownywanie poziome: Wyrownane do strony LEFT. Opcje obejmują:
    • LEWO: Znak wodny po lewej stronie
    • CENTER: Znak wodny pośrodku
    • PRAWO: Znak wodny po prawej stronie

Połącz opcje wyrównania, aby uzyskać dziewięć konfiguracji pozycjonowania, umieszczając znaki wodne precyzyjnie, bez nakładania się na kluczowe treści. W przypadku dokumentów wymagających wielu znaków wodnych lub stempli w różnych miejscach, zapoznaj się z naszymi możliwościami w zakresie adnotacji.

Często Zadawane Pytania

How do I add a text watermark to a PDF in Java?

You can add a text watermark using IronPDF's applyWatermark method. Simply load your PDF document with PdfDocument.fromFile(), then call pdf.applyWatermark() with your text. The method accepts HTML strings, allowing you to style the watermark with CSS properties like color, font, and size.

Can I use images as watermarks instead of text?

Yes, IronPDF supports image watermarks. You can embed images in HTML strings passed to the applyWatermark method, or use the ImageStamper class for more advanced image watermarking with precise control over positioning and opacity.

How do I control the opacity of my watermark?

IronPDF allows you to control watermark opacity through CSS properties in your HTML string. You can set the opacity using the CSS opacity property (values from 0 to 1) or use RGBA color values for text transparency.

Can I rotate watermarks to appear diagonally across the page?

Yes, you can rotate watermarks using CSS transform properties in your HTML string. IronPDF's watermarking feature supports full CSS3 transforms, including rotation at any angle to create diagonal or angled watermarks.

What's the difference between using applyWatermark and TextStamper?

The applyWatermark method is simpler and uses HTML/CSS for styling, while TextStamper provides more programmatic control over text positioning, rotation, and opacity. TextStamper is ideal when you need precise placement or dynamic watermark generation.

How do I position watermarks at specific locations on the page?

IronPDF offers flexible positioning through CSS absolute positioning in HTML watermarks, or you can use TextStamper and ImageStamper classes which provide coordinate-based positioning for exact placement on PDF pages.

Can I add different watermarks to different pages?

Yes, IronPDF supports page-specific watermarking. You can use the stamper classes (TextStamper or ImageStamper) to apply watermarks to specific page ranges or individual pages within your PDF document.

Is it possible to add both text and image watermarks to the same PDF?

Absolutely. IronPDF allows multiple watermarks on the same document. You can combine text and image watermarks by either including both in a single HTML string or applying them separately using multiple watermarking operations.

Darrius Serrant
Full Stack Software Engineer (WebOps)

Darrius Serrant posiada tytuł licencjata z informatyki z Uniwersytetu Miami i pracuje jako Full Stack WebOps Marketing Engineer w Iron Software. Już od młodych lat zainteresował się kodowaniem, postrzegając informatykę jako zarówno tajemniczą, jak i dostępną, co czyni ją doskonałym medium dla kreatywności ...

Czytaj więcej
Gotowy, aby rozpocząć?
Wersja: 2026.4 just released
Still Scrolling Icon

Wciąż przewijasz?

Czy chcesz szybko dowodu?
Uruchom przykład i zobacz, jak Twój kod HTML zamienia się w plik PDF.