GroupDocs.Merger for Java kullanarak görüntüleri dikey olarak birleştirme

Bu adım adım rehberde, GroupDocs.Merger for Java kullanarak birkaç görüntüyü tek uzun resimde birleştirerek dikey foto kolajı oluşturacaksınız. İster kaydırılabilir bir banner, bir rapor ek bölümü ya da basit bir kolaj ihtiyacınız olsun, bu öğretici dikey birleştirmenin neden önemli olduğunu açıklar, kesin API çağrılarını gösterir ve bellek kullanımını düşük tutmak için pratik ipuçları verir.

Hızlı cevaplar

  • Hangi kütüphaneyi kullanabilirim? GroupDocs.Merger for Java.
  • Üçten fazla görüntüyü birleştirebilir miyim? Evet – ihtiyacınız kadar ekleyin.
  • Hangi görüntü formatları destekleniyor? PNG, BMP, JPG ve diğer yaygın statik formatlar.
  • Geliştirme için lisansa ihtiyacım var mı? Ücretsiz deneme test için çalışır; üretim için ücretli lisans gerekir.
  • İşlem bellek açısından verimli mi? Yalnızca gerekli görüntüleri yükleyin ve belleği düşük tutmak için hemen kaydedin.

Görüntü birleştirme nedir?

Görüntü birleştirme, iki veya daha fazla ayrı görüntü dosyasını tek bir birleşik görüntüde birleştirme tekniğidir. Görüntüler dikey olarak istiflendiğinde, sonuç uzun bir fotoğraf şeridi gibi görünür—dikey foto kolajı için veya bir raporun görsel bölümlerini bir araya getirmek için mükemmeldir.

Neden GroupDocs.Merger for Java kullanmalısınız?

GroupDocs.Merger for Java, sadece birkaç kod satırıyla birden fazla görüntüyü dikey olarak birleştirmenizi sağlar. 50+ statik görüntü formatını destekler, dosyaları geçici dosyalar oluşturmadan bellekte işler ve tipik bir sunucuda yığın belleği 200 MB’ın altında tutarak çok sayıda sayfalı belgeleri işleyebilir.

Önkoşullar

  • Java Development Kit (JDK) 8 veya daha yenisi.
  • IntelliJ IDEA veya Eclipse gibi bir IDE.
  • Bağımlılık yönetimi için Maven veya Gradle.
  • Java sözdizimi hakkında temel bilgi (derin görüntü işleme bilgisi gerekmez).

GroupDocs.Merger for Java kurulumu

Maven kullanarak

Bağımlılığı pom.xml dosyanıza ekleyin:

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-merger</artifactId>
    <version>latest-version</version>
</dependency>

Gradle kullanarak

Kütüphaneyi build.gradle dosyanıza dahil edin:

implementation 'com.groupdocs:groupdocs-merger:latest-version'

Doğrudan indirme

Alternatif olarak, en son sürümü GroupDocs.Merger for Java releases adresinden indirebilirsiniz.

Lisans edinme adımları

  1. Ücretsiz deneme – maliyet olmadan tüm özellikleri keşfedin.
  2. Geçici lisans – uzun süreli test için kısa vadeli bir anahtar edinin.
  3. Satın al – üretim kullanımı için kalıcı bir lisans satın alın.

Kütüphane eklendikten sonra, Java dosyanıza ana sınıfı içe aktarın:

import com.groupdocs.merger.Merger;

Görüntüleri dikey olarak birleştirme

Kaynak resimlerinizi yükleyin, API’ye dikey bir düzen kullanmasını söyleyin, her resmi ekleyin ve sonucu kaydedin. Bu dört adımlı desen, minimal kod ve optimum performansla dikey foto kolajı oluşturmanızı sağlar.

Adım 1: yolları tanımlayın ve birleştiriciyi başlatın

İlk olarak, kütüphaneyi kaynak görüntünüze yönlendirin ve birleştirilmiş sonucun nereye kaydedileceğine karar verin.

String filePath = "YOUR_DOCUMENT_DIRECTORY/SAMPLE_PNG";
String filePathOut = new File("YOUR_OUTPUT_DIRECTORY", 
    "CrossJoinMultipleDocuments-" + Paths.get(filePath).getFileName().toString()).getPath();

// Initialize Merger with the first image file.
Merger merger = new Merger(filePath);

Adım 2: birleştirme seçeneklerini yapılandırın

GroupDocs.Merger’a dikey bir düzen istediğinizi söyleyin.

ImageJoinOptions imageJoinOptions = new ImageJoinOptions(ImageJoinMode.Vertical);

Adım 3: ek görüntüler ekleyin

join metodunu, bir öncekinin altına istiflemek istediğiniz her ek resim için kullanın.

merger.join("YOUR_DOCUMENT_DIRECTORY/SAMPLE_BMP", imageJoinOptions); // Second image.
merger.join("YOUR_DOCUMENT_DIRECTORY/SAMPLE_JPG", imageJoinOptions); // Third image.

Bu çağrıyı ihtiyacınız kadar tekrarlayarak dosyaya görüntü ekleyebilir ve uzun bir dikey kolaj oluşturabilirsiniz.

Adım 4: birleştirilmiş görüntüyü kaydedin

Son olarak, birleşik resmi diske yazın.

merger.save(filePathOut);

Beklenen sonuç

Çıktı dosyası, sağlanan tüm görüntüleri üstten alta sıralı bir şekilde içerecek ve raporlar, sunumlar veya web galerileri için kullanılabilecek tek bir uzun resim oluşturacaktır.

Yaygın sorunlar ve çözümler

  • Yanlış dosya yolları – her yolun mevcut bir görüntüyü işaret ettiğinden ve uygulamanızın okuma/yazma izinlerine sahip olduğundan emin olun.
  • Desteklenmeyen format – görüntü tipinin desteklenen statik formatlar (PNG, BMP, JPG) arasında olduğundan emin olun. Animasyonlu GIF’ler bu özellik tarafından işlenmez.
  • Bellek yetersizliği hataları – birçok yüksek çözünürlüklü görüntüyü birleştirirken, birleştirmeden önce yeniden boyutlandırmayı düşünün veya JVM yığın boyutunu (-Xmx bayrağı) artırın.

Pratik uygulamalar

Kullanım durumuNasıl yardımcı olur
Dikey foto kolajı oluşturTatil fotoğraflarını tek bir kaydırılabilir görüntüde birleştirin.
Görsel rapor bölümlerini birleştirBirleştirilmiş PDF dışa aktarımı için grafikler, diyagramlar ve ekran görüntülerini birleştirin.
Pazarlama varlıklarını hazırlayınŞık ve kaydırılabilir bir web bannerı için ürün görüntülerini istifleyin.

Performans ipuçları

  • Aynı anda yalnızca ihtiyacınız olan görüntüleri yükleyin; save sonrası referansları serbest bırakın, böylece çöp toplayıcı belleği temizlesin.
  • Kaynak ve hedef klasörler için SSD depolama kullanarak I/O hızını artırın.
  • Büyük toplu işlemlerde, birleştirmeyi arka plan iş parçacığında çalıştırarak UI’nın yanıt vermesini sağlayın.

Sonuç

Artık GroupDocs.Merger for Java kullanarak görüntüleri dikey olarak birleştirme için eksiksiz, adım adım bir çözümünüz var. Farklı görüntü setleriyle deney yapın, diğer birleştirme modlarını (yatay, ızgara) deneyin ve bu mantığı daha büyük otomasyon hatlarına entegre edin.

Sonraki adımlar

  • ImageJoinMode.Horizontal seçeneğini yan yana kolajlar için keşfedin.
  • Birleştirilmiş görüntüyü, uçtan uca belge oluşturma için GroupDocs.PDF kullanarak PDF üretimiyle birleştirin.

Sıkça Sorulan Sorular

S: Bu yöntemle hangi görüntü formatlarını birleştirebilirim?
A: PNG, BMP, JPG ve diğer yaygın statik formatlar desteklenir.

S: Birleştirebileceğim görüntü sayısında bir sınırlama var mı?
A: Sert bir sınırlama yok; pratik sınırlama bellek kullanılabilirliğidir. Görüntüleri join ile sıralı olarak ekleyin.

S: Çıktı dosyam çok büyük—ne yapabilirim?
A: Birleştirmeden önce kaynak görüntüleri yeniden boyutlandırın veya sıkıştırın, ya da kaliteyi düşürmek için Java’nın ImageIO’sunu kullanın.

S: Animasyonlu GIF’leri dikey olarak birleştirebilir miyim?
A: Mevcut API statik görüntülere odaklanır; animasyonlu GIF’ler dikey birleştirme için desteklenmez.

S: Üretim lisansını nasıl edinebilirim?
A: GroupDocs portalı üzerinden lisans satın alın; test için geçici bir lisans mevcuttur.

Son Güncelleme: 2026-08-15
Test Edilen: GroupDocs.Merger latest version (as of 2026)
Yazar: GroupDocs

Resources

İlgili Eğitimler