PDF’ye Filigran Ekleme: GroupDocs.Watermark for Java Kullanarak Belirli Sayfalara Metin ve Görüntü Filigranları Ekleme

Hızlı Yanıtlar

  • Bireysel sayfaları hedefleyebilir miyim? Evet, belirttiğiniz herhangi bir sayfa indeksine filigran uygulayabilirsiniz.
  • Hangi filigran türleri destekleniyor? Metin ve görüntü filigranları tam olarak desteklenir.
  • Geliştirme için lisansa ihtiyacım var mı? Test için ücretsiz deneme lisansı yeterlidir; üretim için ücretli lisans gereklidir.
  • Hangi Java sürümü gerekiyor? Java 8 ve üzeri; bağımlılık yönetimi için Maven önerilir.
  • Büyük PDF’lere filigran eklemek mümkün mü? GroupDocs.Watermark, tüm belgeyi belleğe yüklemeden 2 GB’a kadar dosyaları işler.

“PDF’ye nasıl filigran eklenir” nedir?

Bu, PDF sayfalarına sahipliği doğrulamak, taslak durumunu göstermek veya kullanımını kısıtlamak amacıyla görünür veya görünmez işaretler—metin dizileri veya görüntüler gibi—programatik olarak yerleştirme sürecidir. Bu işaretler tek tek sayfalara ya da tüm belgeye yerleştirilebilir ve stil, opaklık ve konum açısından özelleştirilebilir.

Önkoşullar

  • GroupDocs.Watermark for Java (sürüm 24.11 veya üzeri).
  • Maven veya projenize manuel JAR ekleme.
  • Temel Java bilgisi ve bir geliştirme IDE’si (IntelliJ IDEA, Eclipse vb.).
  • Koruma altına almak istediğiniz bir PDF dosyası.

GroupDocs.Watermark for Java’ı Kurma

Kurulum Bilgileri

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>

Doğrudan İndirme

You can also download the latest JARs from the official release page: GroupDocs.Watermark for Java releases.

Lisans Edinme

Start with a free trial or temporary license to explore the API. For production use, purchase a full license here: GroupDocs purchase page.

Temel Başlatma ve Kurulum

  1. Maven veya JDK kurulumunu doğrulayın.
  2. Gerekli sınıfları Java kaynak dosyanıza içe aktarın.

PDF’nin İlk Sayfasına Metin Filigranı Nasıl Eklenir?

PDF’yi Watermarker ile yükleyin, bir TextWatermark nesnesi oluşturun, PdfArtifactWatermarkOptions’ı sayfa 1’i hedefleyecek şekilde yapılandırın, filigranı watermarker.add ile ekleyin ve belgeyi kaydedin. Bu sıralama, diğer sayfaları etkilemeden yalnızca ilk sayfaya görünür bir metin katmanı ekler.

Watermarker, belgeleri yüklemek ve filigran uygulamak için temel sınıftır.
TextWatermark, yazı tipi, renk, döndürme ve opaklık ile stil verilebilen metinsel bir katmanı temsil eder.
PdfArtifactWatermarkOptions, belirli PDF sayfalarına filigran uygulama ayarlarını tanımlar.

Adım‑Adım Rehber

  1. TextWatermark oluşturun – metni, yazı tipini, boyutu ve rengi tanımlayın.
  2. Sayfa seçimini yapılandırın – PdfArtifactWatermarkOptions kullanarak sayfa 1’i hedefleyin.
  3. Filigranı ekleyin – watermarker.add(textWatermark, options) metodunu çağırın.
  4. Sonucu kaydedin – watermarker.save("output.pdf").

Pro ipucu: Orijinal içeriği değiştirmeden yalnızca filigran eklemeniz gerekiyorsa PdfLoadOptions.setReadOnly(true) ayarlayın.

Belirli Bir PDF Sayfasına Görüntü Filigranı Nasıl Eklenir?

PDF’yi Watermarker ile yükleyin, görüntü dosyasına işaret eden bir ImageWatermark nesnesi oluşturun, PdfArtifactWatermarkOptions’ı istenen sayfa numarasına (ör. sayfa 3) ayarlayın, filigranı watermarker.add ile ekleyin ve dosyayı kaydedin. Bu, seçilen sayfaya yalnızca yüksek çözünürlüklü bir görüntü katmanı ekler.

ImageWatermark, PDF sayfalarına filigran olarak yerleştirilecek bir görüntüyü (PNG, JPEG, BMP) kapsar.
PdfArtifactWatermarkOptions, belirli PDF sayfalarına filigran uygulama ayarlarını tanımlar.

Uygulama Adımları

  1. ImageWatermark oluşturun – görüntü dosya yolunu ve isteğe bağlı boyutları sağlayın.
  2. Sayfa filtresini ayarlayın – PdfArtifactWatermarkOptions.setPageNumber(3) sayfa 3’ü hedefler.
  3. Uygulayın ve kaydedin – watermarker.add ile filigranı ekleyin ve belgeyi kalıcı hale getirin.
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\

Yaygın Sorunlar ve Çözümler

  • Filigran görünmüyor: PDF’nin şifre korumalı veya şifreli olmadığından emin olun; gerekiyorsa yüklerken şifreyi sağlayın.
  • Görüntü bozulması: scaleFactor‘ı ayarlayın veya daha yüksek çözünürlüklü bir kaynak görüntü sağlayın.
  • Büyük dosyalarda performans: Akışı etkinleştirmek ve bellek tüketimini azaltmak için PdfLoadOptions.setStreamSize(… ) kullanın.

Sıkça Sorulan Sorular

S: Aynı sayfaya hem metin hem de görüntü filigranı ekleyebilir miyim?
C: Evet, aynı sayfa filtresiyle her filigran türü için watermarker.add çağırın; eklenme sırasına göre katmanlanırlar.

S: GroupDocs.Watermark şifre korumalı PDF’lerle çalışır mı?
C: Kesinlikle. Watermarker oluştururken şifreyi PdfLoadOptions‘a geçirin.

S: İşleyebileceğim maksimum dosya boyutu nedir?
C: Kütüphane, dosyanın tamamını belleğe yüklemeden 2 GB‘a kadar PDF’leri işleyebilir; bu, akış mimarisi sayesinde mümkün olur.

S: Filigranı yarı saydam yapmak mümkün mü?
C: Filigran nesnesinin opaklık özelliğini ayarlayın (ör. textWatermark.setOpacity(0.5)).

S: Hangi Java sürümleri destekleniyor?
C: Java 8, 11 ve 17 tam olarak desteklenir; daha yeni LTS sürümleri de çalışır.

Son Güncelleme: 2026-05-22
Test Edilen Versiyon: GroupDocs.Watermark 24.11 for Java
Yazar: GroupDocs

İlgili Eğitimler