Java'da PDF'lere Nasıl Özelleştirilmiş Filigranlar Ekleyebilirim?

Bir PDF'ye Metin Filigranı Nasıl Uygularım?

Bir PDF belgesinin her sayfasına metin damgalamak için applyWatermark yöntemini kullanın. Yöntem bir HTML dizesi kabul eder, bu yüzden filigranı herhangi bir CSS özelliği ile stillendirebilirsiniz: yazı tipi ailesi, boyutu, rengi, harf aralığı veya metin gölgesi. Aşağıdaki örnek, "Gizli" şeklinde kırmızı bir belge işaretler ve bu, en yaygın denetim izi ve erişim kontrol senaryosunu kapsar.

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

applyWatermark çağrısı, filigranı tek bir işlemde tüm sayfalara ekler. Varsayılan olarak, filigran %50 opaklıkta işlenir ve her sayfada ortalanmıştır. Kütüphanenin tüm özelliklerini etkinleştirmek için, herhangi bir PDF işlemi gerçekleştirmeden önce IronPDF lisans anahtarınızı yapılandırın. applyWatermark'ye iletilen HTML, geçerli herhangi bir HTML öğesini kabul eder, bu nedenle çok satırlı filigranlar için

Bir PDF'ye Resim Filigranı Nasıl Eklerim?

Görsel filigranlar, HTML dizisi içinde bir etiketi sarmalanarak applyWatermark yöntemi aracılığıyla çalışır. Şeffaf arka plana sahip PNG dosyaları, resim PDF sayfasına yerleştirildiğinde şeffaflık korunduğu için logo filigranları için idealdir. JPEG, GIF, SVG ve BMP formatları da desteklenir.

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

etiketindeki CSS özellikleri, boyut, pozisyon ve saydamlığı kontrol eder:

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

Görüntü yolu, çalışma zamanında JVM'nin çalışma dizininden erişilebilir olmalıdır. Sunucu kurulumları için, yol çözümleme sorunlarını önlemek amacıyla mutlak yollar kullanın veya görüntüyü src özniteliği içine Base64 veri URI olarak gömün.

Görsel Filigranlar İçin Hangi Dosya Formatları Desteklenir?

IronPDF, filigranlarda PNG, JPEG, GIF, SVG ve BMP görüntü formatlarını destekler. Şeffaf arka plana sahip PNG, logo filigranları için en temiz sonuçları verir. Çıktı dosyası image_watermark.pdf, her sayfa için 100 piksel genişliğinde ve %50 varsayılan saydamlıkta ortalanmış olarak görüntüyü gösterir. Başka bir filigranda kullanılmak üzere mevcut PDF'den görüntü çıkarma işlemi için PDF'lerden görüntü çıkarma kılavuzunu inceleyin.

---

Bu türden favori kütüphanem IronPDF'dir. PDF dosyalarının hızlı ve verimli bir şekilde işlenmesine olanak tanır. Ayrıca, PDF/A formatına dışa aktarma ve dijital imzalama gibi birçok değerli özelliğe sahiptir.

Milan Jovanovic

Microsoft MVP

Vaka çalışmasını görüntüle

IronOCR, manuel işleme maliyetinden yıllık 40.000 USD tasarruf etmemizi sağlıyor, üretkenliği artırıyor ve yüksek etkili görevler için kaynakları serbest bırakıyor. Kesinlikle tavsiye ederim.

Brent Matzelle

Teknoloji Müdürü, OPYN

Vaka çalışmasını görüntüle

IronSuite, operasyonlarımızda kritik bir rol oynar. Bunlar, iş süreçlerinde verimliliği artıran, kat planları oluşturmak ve envanter yönetimini geliştirmek gibi araçlardır.

David Jones

Baş Yazılım Mühendisi, Agorus Build

Vaka çalışmasını görüntüle

Filigran Opaklığı ve Hizalamasını Nasıl Kontrol Ederim?

applyWatermark yöntemi, HTML dizesinden sonra saydamlık ve hizalama parametrelerini kabul eder. Opaklık 0 (tamamen şeffaf) ile 100 (tamamen opak) arasında bir tamsayıdır. Değerler 20 ile 40 arasında, filigranı gövde metnini örtmeden görünür tutmak için çoğu belge için iyi çalışır. VerticalAlignment ve HorizontalAlignment sabitleri, sayfanın hangi köşesinin veya kenarının filigranın hedefi olduğunu kontrol eder.

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

Üç isteğe bağlı parametrenin birleşimi, dikey ve yatay hizalamanın her kesişimi için dokuz farklı konumlandırma seçeneği sunar. Aynı sayfada birden fazla konumda filigran gerektiren veya yalnızca belirli bir sayfa aralığına uygulanan filigranların gerekli olduğu kullanım durumları için, damga sınıfları daha ince kontrol sağlar. Katmanlı bileşen teknikleri için arka planlar ve ön planlar kılavuzuna bakınız.

TextStamper ve ImageStamper ile Gelişmiş Filigranları Nasıl Uygularım?

applyWatermark yöntemi çoğu filigranlama ihtiyacını karşılar, ancak TextStamper ve ImageStamper sınıfları, tam piksel koordinatları, sayfa aralığı hedefleme veya dinamik metin üretimi gerektiğinde programatik kontrol sunar. Her iki sınıf da com.ironsoftware.ironpdf.stamp paketine aittir.

TextStamper bir dize değeri kabul eder ve yazı tipi, yazı tipi boyutu, yazı rengi, yatay ve dikey hizalama ve saydamlık için özellikler sunar. Ayrıca bir tamsayı olarak döndürmeyi de destekler (dereceler). ImageStamper resim için bir dosya yolu veya bayt dizisi kabul eder ve TextStamper ile aynı hizalama ve saydamlık kontrollerini sunar.

applyWatermark üzerinde damga sınıflarının temel avantajı, belirli sayfaları hedefleyebilme yeteneğidir. Bir raporun sadece kapak sayfasını veya bir sözleşmenin son onay sayfasını damgalamak gibi gerektiğinde yalnızca ihtiyaç duyulan sayfalara filigran uygulamak için stamp yöntemine sıfırdan başlayan sayfa numaraları listesi geçirin.

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

stamp yöntemi, filigranı hangi sayfaların alacağını kesin bir şekilde kontrol etmenizi sağlayan sıfırdan başlayan sayfa numaraları List kabul eder. Hiçbir sayfa listesi sağlanmadığında, damga tüm sayfalara uygulanır. Bu, uygulamanızın her üretilen PDF'de benzersiz bir işlem kimliği, kullanıcı adı veya zaman damgası gömülü olarak filigranlar ürettiği durumlarda TextStamper'yi doğru seçim haline getirir.

Yüzlerce PDF'nin müşteri özel filigranları ile damgalama gibi toplu işlemler için, her PdfDocument'yi bir döngü içinde yükleyin ve damgalayın, ardından bir sonraki yinelemeden önce saveAs çağrısını yapın. IronPDF, her belgeyi bağımsız olarak işler, bu nedenle bellek kullanımı sınırlı kalır. Java PDF damga kılavuzu, ImageStamper ve ek damgalama seçeneklerini detaylı bir şekilde kapsar ve IronPDF Java belgeleri tamamlayıcı API referansını sağlar.

Java'da PDF Filigranlamanın Sıradaki Adımları Nelerdir?

Bu kılavuz, IronPDF for Java ile PDF'lere filigran eklemek için dört yaklaşımı ele aldı: applyWatermark aracılığıyla basit metin filigranları, HTML etiketleri kullanarak resim filigranları, yöntem parametreleri ile opaklık ve hizalama kontrolü ve gelişmiş kullanım durumları için TextStamper ve ImageStamper ile programatik damgalama.

Ücretsiz denemenize başlayın ve Java uygulamanızda filigranlamayı test edin. Deneme, damgalama ve filigranlama özelliklerine tam erişim içerir ve değerlendirme süresi sınırı yoktur. Dağıtıma hazır olduğunuzda, kullanımınıza uygun olan katmanı bulmak için lisanslama seçeneklerine bakın.

Başka neler yapabileceğinizi görmek için hazır mısınız? Tam öğretici sayfasını burada inceleyin: IronPDF for Java Nasıl Yapılır Kılavuzları