Jak dodać znak wodny do PDF: Dodawanie znaków wodnych tekstowych i graficznych do konkretnych stron przy użyciu GroupDocs.Watermark dla Javy

W dzisiejszym szybko zmieniającym się środowisku cyfrowym, how to watermark pdf pliki w sposób bezpieczny są główną troską programistów i właścicieli treści. Niezależnie od tego, czy musisz oznaczyć własność, wskazać status wersji roboczej, czy chronić poufne dane, dodawanie znaków wodnych do wybranych stron PDF daje precyzyjną kontrolę bez modyfikacji całego dokumentu. Ten samouczek przeprowadzi Cię przez dodawanie zarówno tekstowych, jak i graficznych znaków wodnych do konkretnych stron przy użyciu GroupDocs.Watermark dla Javy.

Szybkie odpowiedzi

  • Czy mogę celować w poszczególne strony? Tak, możesz zastosować znaki wodne do dowolnego indeksu strony, który określisz.
  • Jakie typy znaków wodnych są obsługiwane? Tekstowe i graficzne znaki wodne są w pełni obsługiwane.
  • Czy potrzebna jest licencja do rozwoju? Licencja próbna działa w testach; licencja płatna jest wymagana w produkcji.
  • Jaka wersja Javy jest wymagana? Java 8 lub wyższa; Maven jest zalecany do zarządzania zależnościami.
  • Czy można znakować duże pliki PDF? GroupDocs.Watermark przetwarza pliki do 2 GB bez ładowania całego dokumentu do pamięci.

Co to jest „how to watermark pdf”?

Jest to proces programistycznego osadzania widocznych lub niewidzialnych znaków — takich jak ciągi tekstowe lub obrazy — na stronach PDF w celu potwierdzenia własności, wskazania statusu wersji roboczej lub ograniczenia użycia. Te znaki mogą być umieszczane na poszczególnych stronach lub w całym dokumencie i mogą być dostosowywane pod względem stylu, przezroczystości i pozycji.

„How to watermark pdf” odnosi się do procesu programistycznego osadzania widocznych lub niewidzialnych znaków — takich jak ciągi tekstowe lub obrazy — na stronach PDF w celu potwierdzenia własności lub przekazania ograniczeń użytkowania.

Wymagania wstępne

  • GroupDocs.Watermark for Java (wersja 24.11 lub nowsza).
  • Maven lub ręczny import JAR‑ów do projektu.
  • Podstawowa znajomość Javy oraz środowisko IDE (IntelliJ IDEA, Eclipse itp.).
  • Plik PDF, który chcesz chronić.

Konfiguracja GroupDocs.Watermark dla Javy

Informacje o instalacji

Add the GroupDocs.Watermark repository and dependency to your pom.xml:

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/watermark/java/</url>
   </repository>
</repositories>

<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-watermark</artifactId>
      <version>24.11</version>
   </dependency>
</dependencies>

Bezpośrednie pobranie

Możesz również pobrać najnowsze pliki JAR z oficjalnej strony wydań: GroupDocs.Watermark for Java releases.

Uzyskanie licencji

Rozpocznij od darmowej licencji próbnej lub tymczasowej, aby zapoznać się z API. Do użytku produkcyjnego zakup pełną licencję tutaj: GroupDocs purchase page.

Podstawowa inicjalizacja i konfiguracja

  1. Zweryfikuj instalację Maven lub JDK.
  2. Zaimportuj wymagane klasy do swojego pliku źródłowego Java.

Jak dodać znak wodny tekstowy do pierwszej strony PDF?

Załaduj PDF przy użyciu Watermarker, utwórz obiekt TextWatermark, skonfiguruj PdfArtifactWatermarkOptions, aby wybrać stronę 1, dodaj znak wodny za pomocą watermarker.add i zapisz dokument. Ta sekwencja dodaje widoczną warstwę tekstową wyłącznie do pierwszej strony, nie wpływając na pozostałe.

Watermarker jest główną klasą do ładowania dokumentów i stosowania znaków wodnych.
TextWatermark reprezentuje nakładkę tekstową, którą można stylizować czcionką, kolorem, obrotem i przezroczystością.
PdfArtifactWatermarkOptions definiuje ustawienia stosowania znaków wodnych do konkretnych stron PDF.

Przewodnik krok po kroku

  1. Utwórz TextWatermark – określ tekst, czcionkę, rozmiar i kolor.
  2. Skonfiguruj wybór stron – użyj PdfArtifactWatermarkOptions, aby wybrać stronę 1.
  3. Dodaj znak wodny – wywołaj watermarker.add(textWatermark, options).
  4. Zapisz wynik – watermarker.save("output.pdf").

Wskazówka: Ustaw PdfLoadOptions.setReadOnly(true), jeśli potrzebujesz jedynie dodać znaki wodne bez modyfikacji oryginalnej treści.

Jak dodać znak wodny graficzny do konkretnej strony PDF?

Załaduj PDF przy użyciu Watermarker, utwórz obiekt ImageWatermark wskazujący na plik obrazu, ustaw PdfArtifactWatermarkOptions na żądany numer strony (np. strona 3), dodaj znak wodny za pomocą watermarker.add i zapisz plik. To dodaje wysokiej rozdzielczości nakładkę graficzną wyłącznie na wybraną stronę.

ImageWatermark kapsułkuje obraz (PNG, JPEG, BMP), który ma być umieszczony jako znak wodny na stronach PDF.
PdfArtifactWatermarkOptions definiuje ustawienia stosowania znaków wodnych do konkretnych stron PDF.

Kroki implementacji

  1. Utwórz ImageWatermark – podaj ścieżkę do pliku obrazu oraz opcjonalne wymiary.
  2. Ustaw filtr stron – PdfArtifactWatermarkOptions.setPageNumber(3) wybiera stronę 3.
  3. Zastosuj i zapisz – dodaj znak wodny poprzez watermarker.add i zachowaj dokument.
import com.groupdocs.watermark.Watermarker;
import com.groupdocs.watermark.options.PdfLoadOptions;
import com.groupdocs.watermark.options.PdfArtifactWatermarkOptions;
import com.groupdocs.watermark.watermarks.Font;
import com.groupdocs.watermark.watermarks.TextWatermark;

// Create a new instance of PdfLoadOptions
PdfLoadOptions loadOptions = new PdfLoadOptions();

// Initialize the Watermarker with your PDF file path and load options
Watermarker watermarker = new Watermarker("YOUR_DOCUMENT_DIRECTORY/document.pdf\

Typowe problemy i rozwiązania

  • Znak wodny nie pojawia się: Upewnij się, że PDF nie jest chroniony hasłem ani zaszyfrowany; podaj hasło przy ładowaniu, jeśli to konieczne.
  • Zniekształcenie obrazu: Dostosuj scaleFactor lub użyj obrazu o wyższej rozdzielczości.
  • Wydajność przy dużych plikach: Użyj PdfLoadOptions.setStreamSize(… ), aby włączyć strumieniowanie i zmniejszyć zużycie pamięci.

Najczęściej zadawane pytania

Q: Czy mogę dodać zarówno tekstowy, jak i graficzny znak wodny na tej samej stronie?
A: Tak, wywołaj watermarker.add dla każdego typu znaku wodnego z tym samym filtrem stron; będą one nakładane w kolejności dodania.

Q: Czy GroupDocs.Watermark działa z PDF‑ami chronionymi hasłem?
A: Absolutnie. Przekaż hasło do PdfLoadOptions przy tworzeniu Watermarker.

Q: Jaki jest maksymalny rozmiar pliku, który mogę przetworzyć?
A: Biblioteka obsługuje PDF‑y do 2 GB bez ładowania całego pliku do pamięci, dzięki architekturze strumieniowej.

Q: Czy istnieje sposób, aby znak wodny był półprzezroczysty?
A: Ustaw właściwość opacity na obiekcie znaku wodnego (np. textWatermark.setOpacity(0.5)).

Q: Jakie wersje Javy są obsługiwane?
A: Java 8, 11 i 17 są w pełni obsługiwane; nowsze wersje LTS również działają.

Ostatnia aktualizacja: 2026-05-22
Testowano z: GroupDocs.Watermark 24.11 for Java
Autor: GroupDocs

Powiązane samouczki