Java’da PDF Belgelerine Görüntü Filigranı Ekleme 5 Adımda

1. API istemcisini başlatın: ApiClient örneğini istemci kimliğiniz ve gizli anahtarınızla oluşturun.

ApiClient apiClient = new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
WatermarkApi watermarkApi = new WatermarkApi(apiClient);

Bu adım, Java kodunuzu GroupDocs.Watermark Cloud hizmetine bağlar. Daha fazla ayrıntı için API referansına bakın.

2. Kaynak PDF dosyasını belirtin: İşaretlemek istediğiniz PDF’ye işaret eden bir FileInfo nesnesi oluşturun.

FileInfo fileInfo = new FileInfo();
fileInfo.setFilePath("input.pdf");

Dosya, istek yapılmadan önce GroupDocs depolama alanınıza yüklenmelidir.

3. Görüntü filigranını yapılandırın: Görüntü yolunu, opaklığı, ölçek faktörünü, dönüşü ve hizalamayı tanımlayın.

   ImageWatermark imageWatermark = new ImageWatermark();
   imageWatermark.setImagePath("watermark.png");
   imageWatermark.setOpacity(0.5);
   imageWatermark.setScaleFactor(0.3);
   imageWatermark.setHorizontalAlignment(HorizontalAlignment.CENTER);
   imageWatermark.setVerticalAlignment(VerticalAlignment.CENTER);
   imageWatermark.setMargin(new Margin(10, 10, 10, 10));
   

   İstenilen görünümü elde etmek için bu değerleri ayarlayın; opaklık şeffaflığı kontrol ederken, ölçek faktörü sayfaya göre boyutu belirler.

4. Filigran seçeneklerini ve çıktı yolunu ayarlayın: Dosya bilgisi ve filigranı bir WatermarkOptions nesnesine birleştirin.

   WatermarkOptions options = new WatermarkOptions();
   options.setFileInfo(fileInfo);
   options.setImageWatermark(imageWatermark);
   options.setOutputPath("output.pdf");
   

   outputPath, hizmete oluşturulan PDF’nin nerede saklanacağını bildirir.

5. İsteği yürütün: Bir AddWatermarkRequest oluşturun ve API’yi çağırın. Başarı veya hata yanıtlarını işleyin.

   AddWatermarkRequest request = new AddWatermarkRequest(options);
   try {
       AddWatermarkResponse response = watermarkApi.addWatermark(request);
       System.out.println("Watermark added successfully. Output file: " + response.getPath());
   } catch (Exception e) {
       System.err.println("Error adding watermark: " + e.getMessage());
   }
   

   Yürütmeden sonra, filigranlı PDF belirttiğiniz konumda bulunur.

Tam Kod Örneği: Java’da PDF Belgelerine Görüntü Filigranı Ekleme

Aşağıdaki örnek, istemci başlatmadan su işareti eklenmiş PDF’yi kaydetmeye kadar tam uygulamayı gösterir.

import com.groupdocs.cloud.watermark.api.WatermarkApi;
import com.groupdocs.cloud.watermark.client.ApiClient;
import com.groupdocs.cloud.watermark.model.AddWatermarkRequest;
import com.groupdocs.cloud.watermark.model.AddWatermarkResponse;
import com.groupdocs.cloud.watermark.model.FileInfo;
import com.groupdocs.cloud.watermark.model.ImageWatermark;
import com.groupdocs.cloud.watermark.model.Margin;
import com.groupdocs.cloud.watermark.model.WatermarkOptions;
import com.groupdocs.cloud.watermark.model.enums.HorizontalAlignment;
import com.groupdocs.cloud.watermark.model.enums.VerticalAlignment;

public class AddImageWatermarkExample {
    public static void main(String[] args) {
        // Initialize API client (replace with your actual credentials)
        ApiClient apiClient = new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
        WatermarkApi watermarkApi = new WatermarkApi(apiClient);

// Input PDF file information
        FileInfo fileInfo = new FileInfo();
        fileInfo.setFilePath("input.pdf");

// Image watermark configuration
        ImageWatermark imageWatermark = new ImageWatermark();
        imageWatermark.setImagePath("watermark.png");          // Path to watermark image
        imageWatermark.setOpacity(0.5);                        // 50% opacity
        imageWatermark.setScaleFactor(0.3);                    // 30% of page size
        imageWatermark.setRotationAngle(0);                    // No rotation
        imageWatermark.setHorizontalAlignment(HorizontalAlignment.CENTER);
        imageWatermark.setVerticalAlignment(VerticalAlignment.CENTER);
        imageWatermark.setMargin(new Margin(10, 10, 10, 10));  // 10 points margin on all sides

// Watermark options
        WatermarkOptions options = new WatermarkOptions();
        options.setFileInfo(fileInfo);
        options.setImageWatermark(imageWatermark);
        options.setOutputPath("output.pdf"); // Resulting PDF with watermark

// Create request and call API
        AddWatermarkRequest request = new AddWatermarkRequest(options);
        try {
            AddWatermarkResponse response = watermarkApi.addWatermark(request);
            System.out.println("Watermark added successfully. Output file: " + response.getPath());
        } catch (Exception e) {
            System.err.println("Error adding watermark: " + e.getMessage());
            e.printStackTrace();
        }
    }
}

Not: Bu kod örneği temel işlevselliği gösterir. Projenizde kullanmadan önce dosya yollarını (input.pdf, watermark.png, output.pdf) gerçek dosya konumlarınıza göre güncellediğinizden, tüm gerekli bağımlılıkların doğru şekilde yüklendiğinden emin olun ve geliştirme ortamınızda kapsamlı bir şekilde test edin. Herhangi bir sorunla karşılaşırsanız, lütfen resmi belgeler adresine bakın veya destek ekibi ile iletişime geçin.

cURL ve REST API ile PDF Belgelerine Görüntü Filigranı Uygulama

Aşağıda, Java kodu yazmadan aynı sonucu elde etmek için cURL ile kullanabileceğiniz REST çağrıları bulunmaktadır.

1. Erişim belirteci alın

   curl -X POST "https://api.groupdocs.cloud/v2.0/auth/token" \
        -H "Content-Type: application/json" \
        -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'
   

   Yanıt, sonraki çağrılarda kullanılan bir access_token içerir.

2. Kaynak PDF’yi yükleyin

   curl -X POST "https://api.groupdocs.cloud/v2.0/storage/upload?path=input.pdf" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
        -F "file=@/path/to/input.pdf"
   

3. Filigran görüntüsünü yükleyin

   curl -X POST "https://api.groupdocs.cloud/v2.0/storage/upload?path=watermark.png" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
        -F "file=@/path/to/watermark.png"
   

4. Görüntü filigranı ekleyin

curl -X POST "https://api.groupdocs.cloud/v2.0/watermark/add" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfo": { "filePath": "input.pdf" },
           "imageWatermark": {
               "imagePath": "watermark.png",
               "opacity": 0.5,
               "scaleFactor": 0.3,
               "horizontalAlignment": "Center",
               "verticalAlignment": "Center",
               "margin": { "top": 10, "right": 10, "bottom": 10, "left": 10 }
           },
           "outputPath": "output.pdf"
         }'

Bu istek, Java kod mantığını yansıtarak aynı opaklık, ölçekleme ve hizalama ayarlarını uygular.

5. Filigranlı PDF’yi indirin

   curl -X GET "https://api.groupdocs.cloud/v2.0/storage/download?path=output.pdf" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
        -o output.pdf
   

İstek gövdeleri ve desteklenen parametreler hakkında daha fazla ayrıntı için, resmi API belgelerine bakın.

Kurulum ve Yapılandırma GroupDocs.Watermark Cloud SDK for Java

Maven bağımlılığını pom.xml dosyanıza ekleyin (veya eşdeğer Gradle snippet’ini). Kütüphane Maven Central’da barındırılmaktadır.

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-watermark-cloud</artifactId>
    <version>23.8</version>
</dependency>

Ayrıca geçerli bir GroupDocs Cloud hesabına da ihtiyacınız var. Client ID ve Client Secret değerlerinizi GroupDocs portalından alın. SDK bulut hizmetiyle iletişim kurduğundan ek bir çalışma zamanı kurulumu gerekmez.

PDF Belgeleri için Görüntü Filigran Seçeneklerini İnce Ayar Yapma

SDK, filigranın görsel görünümünü kontrol etmenizi sağlayan çeşitli özellikler sunar.

Opaklığı Ayarla

imageWatermark.setOpacity(0.75); // 75% opacity for a more visible watermark

Opaklık değerleri 0.0 (tamamen şeffaf) ile 1.0 (tamamen opak) arasında değişir.

Ölçek Faktörünü Değiştir

imageWatermark.setScaleFactor(0.5); // Watermark occupies 50% of the page width

Ölçek faktörü, filigran boyutunu sayfa boyutlarına göre belirler.

Hizalama ve Kenar Boşluklarını Ayarla

imageWatermark.setHorizontalAlignment(HorizontalAlignment.RIGHT);
imageWatermark.setVerticalAlignment(VerticalAlignment.BOTTOM);
imageWatermark.setMargin(new Margin(20, 20, 20, 20));

Bu ayarlar, filigranı sağ alt köşeye 20 puanlık bir kenar boşluğu ile yerleştirir.

Yapılandırılabilir özelliklerin tam listesi için, API referansına bakın.

Sonuç

Java’da PDF belgelerine resim filigranı eklemek, GroupDocs.Watermark Cloud SDK for Java kullandığınızda basit bir görevdir. SDK, tüm düşük seviyeli PDF manipülasyonunu yönetir ve opaklık, ölçekleme ve konumlandırma gibi görsel yönlere odaklanmanızı sağlar. Yerel bir Java uygulamasını mı yoksa bulut tabanlı bir cURL iş akışını mı tercih ederseniz edin, aynı yüksek kaliteli sonuçlar performanstan ödün vermeden elde edilebilir. Üretim kullanımı için uygun bir lisans almayı unutmayın; fiyatlandırma detayları ürün sayfasında mevcuttur ve değerlendirme için bir geçici lisans sayfası kullanılabilir.

FAQs

• Java’da kalite kaybı olmadan PDF’ye resim filigranı nasıl eklenir?
  scaleFactor özelliğini kullanarak filigranı sayfaya göre boyutlandırın ve kaynak PDF’nin orijinal DPI’sını koruyun. SDK, PDF’nin çözünürlüğünü korur, böylece filigran herhangi bir yakınlaştırma seviyesinde net görünür.

• Aynı PDF’ye birden fazla filigran ekleyebilir miyim?
  Evet. Farklı yapılandırmalara sahip ayrı ImageWatermark nesneleri oluşturun ve bunları addWatermark metodunu birden fazla kez çağırarak veya istekte bir listeye ekleyerek sıralı bir şekilde ekleyin.

• Filigran için desteklenen görüntü formatları nelerdir?
  API, PNG, JPG, BMP, GIF ve TIFF gibi yaygın görüntü türlerini kabul eder. PNG, kayıpsız kalite ve şeffaflık desteği nedeniyle önerilir.

• Uygulamadan önce filigranı önizlemenin bir yolu var mı?
  Filigranlı geçici bir PDF oluşturmak ve inceleme için indirmek için GroupDocs.Watermark Cloud SDK for Java’yı kullanabilirsiniz. Bu, aynı addWatermark çağrısını, çıkış yolunu geçici bir konuma işaret edecek şekilde kullanır.

Daha Fazla

• Java kullanarak Görsellere Filigran Ekle
• Java’da Word’e Filigran Ekle - Filigran Oluşturucu
• PDF’ye Görsel Filigran Ekle | .NET Kullanarak PDF Belgelerine Filigran Ekleme