Java’da TIFF’ten JPG’ye Dönüştürme Gereksinimleri

Java uygulamaları, taranmış belgeler, tıbbi görüntüler veya uydu fotoğrafları işlediğinde genellikle girdi olarak çok sayfalı TIFF dosyaları alır. Dönüşüm, ayrıntıyı korumalı, yüksek çözünürlüklü çıktıyı desteklemeli ve sonraki işlemeyi basitleştirmek için her sayfa için ayrı bir JPG oluşturmalıdır. Manuel dönüşüm araçları scriptlenemez ve ölçeklenemez; bu da toplu veya gerçek zamanlı senaryolar için otomatik bir kütüphaneyi gerekli kılar.

Conholdate.Total for Java, TIFF’i JPG’ye Java’da Nasıl Dönüştürür

Conholdate.Total for Java, TIFF formatını, çok sayfalı görüntüler dahil, anlayan özel bir dönüşüm motoru sunar ve yüksek kaliteli JPG çıktısı üretebilir. SDK, çıktı kalitesini, DPI çözünürlüğünü ve sayfa seçimini ayarlamanıza olanak tanır; bu da görüntü doğruluğu üzerinde hassas kontrol ihtiyacını karşılar. Her özelliği adım adım anlatan dokümantasyon ve API referansları mevcuttur: resmi dokümantasyonu ve API referansını inceleyin. Basit bir Maven bağımlılığıyla, kütüphane herhangi bir Java projesine sorunsuz bir şekilde entegre olur.

Java’da TIFF’ten JPG Dönüştürme Uygulaması

Aşağıdaki adımlar, projeyi kurmanıza, SDK’yı başlatmanıza ve dönüşümü gerçekleştirmenize rehberlik eder.

Conholdate.Total için Maven Bağımlılığı Ekle

Conholdate Maven deposunu ve SDK bağımlılığını pom.xml dosyanıza ekleyin. Bu, kütüphanenin derleme zamanında kullanılabilir olmasını sağlar.

<repositories>
  <repository>
    <id>conholdate-repo</id>
    <name>Conholdate Maven Repository</name>
    <url>https://repository.conholdate.com/repo/</url>
  </repository>
</repositories>

<dependency>
  <groupId>com.conholdate</groupId>
  <artifactId>conholdate-total</artifactId>
  <version>24.9</version>
  <type>pom</type>
</dependency>

En son sürümü indirme sayfasından indirebilirsiniz.

ConversionHandler’ı Başlat

Bir ConversionHandler örneği oluşturun. SDK, geçerli bir lisansın uygulamanızın başka bir yerinde ayarlandığını varsayar.

ConversionHandler conversionHandler = new ConversionHandler();

Ek başlatma seçenekleri için ConversionHandler sınıfına bakın.

TIFF Dosyasını Yükle ve Sayfa Sayısını Al

Kaynak TIFF hakkında, sayfa sayısı dahil, bilgi almak için LoadOptions ve getFileInfo kullanın.

LoadOptions loadOptions = new LoadOptions();
FileInfo fileInfo = conversionHandler.getFileInfo("sample.tif", loadOptions);
TiffFileInfo tiffInfo = (TiffFileInfo) fileInfo;
int pageCount = tiffInfo.getPages().size();

Bu adım, Java’da TIFF’ten JPG’ye dönüştürme yardımcı programı için esastır, çünkü sayfa başına işleme olanak tanır.

JPG Dönüştürme Seçeneklerini Yapılandır

İstenen kaliteyi, çözünürlüğü ve dönüştürülecek belirli sayfayı ayarlayın. Bu ayarlar Java’da Yüksek Çözünürlüklü TIFF’ten JPG’ye Dönüştürme iş akışının bir parçasıdır.

JpgConvertOptions jpgOptions = new JpgConvertOptions();
jpgOptions.setQuality(90);          // 0‑100
jpgOptions.setResolution(300);      // DPI
jpgOptions.setPageNumber(i + 1);    // 1‑based page index

Dönüşüm Döngüsünü Çalıştırın ve Çıktıyı Doğrulayın

Her sayfayı yineleyin, dönüşümü gerçekleştirin ve oluşan JPG dosyasının mevcut olduğunu doğrulayın.

for (int i = 0; i < pageCount; i++) {
    jpgOptions.setPageNumber(i + 1);
    String outputPath = Paths.get("output", "page_" + (i + 1) + ".jpg").toString();
    conversionHandler.convert("sample.tif", loadOptions, jpgOptions, outputPath);

File resultFile = new File(outputPath);
    if (resultFile.exists() && resultFile.length() > 0) {
        System.out.println("Successfully converted page " + (i + 1));
    } else {
        System.err.println("Conversion failed for page " + (i + 1));
    }
}

Bu, Java’da Toplu TIFF’ten JPG’ye Dönüştürme işlemini minimal kodla gösterir.

Tam Kod Örneği: Yüksek Çözünürlüklü Çıktı ile TIFF’i JPG’ye Dönüştür

Aşağıdaki kod, yukarıda açıklanan tam uygulamayı gösterir.

import com.groupdocs.conversion.ConversionHandler;
import com.groupdocs.conversion.filetypes.FileInfo;
import com.groupdocs.conversion.filetypes.tiff.TiffFileInfo;
import com.groupdocs.conversion.options.load.LoadOptions;
import com.groupdocs.conversion.options.convert.JpgConvertOptions;
import java.io.File;
import java.nio.file.Paths;

public class TiffToJpgConverter {
    public static void main(String[] args) {
        // Input TIFF file (can be multi‑page)
        String inputPath = "sample.tif";

// Directory where JPG files will be written
        String outputDir = "output";

// Desired output quality and resolution
        int outputQuality = 90;      // 0‑100
        int outputResolution = 300; // DPI

// Ensure the output directory exists
        File outFolder = new File(outputDir);
        if (!outFolder.exists()) {
            outFolder.mkdirs();
        }

try {
            // Initialise the conversion handler (license is assumed to be set elsewhere)
            ConversionHandler conversionHandler = new ConversionHandler();

// Load options – can be left empty for default behaviour
            LoadOptions loadOptions = new LoadOptions();

// Retrieve file information to know how many pages the TIFF contains
            FileInfo fileInfo = conversionHandler.getFileInfo(inputPath, loadOptions);
            if (!(fileInfo instanceof TiffFileInfo)) {
                System.err.println("The provided file is not a TIFF image.");
                return;
            }
            TiffFileInfo tiffInfo = (TiffFileInfo) fileInfo;
            int pageCount = tiffInfo.getPages().size();

// Convert each page of the TIFF to a separate JPG
            for (int i = 0; i < pageCount; i++) {
                JpgConvertOptions jpgOptions = new JpgConvertOptions();
                jpgOptions.setQuality(outputQuality);
                jpgOptions.setResolution(outputResolution);
                jpgOptions.setPageNumber(i + 1); // pages are 1‑based

String outputPath = Paths.get(outputDir, "page_" + (i + 1) + ".jpg").toString();

// Perform the conversion
                conversionHandler.convert(inputPath, loadOptions, jpgOptions, outputPath);

// Simple validation of the result
                File resultFile = new File(outputPath);
                if (resultFile.exists() && resultFile.length() > 0) {
                    System.out.println("Successfully converted page " + (i + 1) + " to " + outputPath);
                } else {
                    System.err.println("Conversion failed for page " + (i + 1));
                }
            }
        } catch (Exception ex) {
            System.err.println("Error during TIFF to JPG conversion: " + ex.getMessage());
            ex.printStackTrace();
        }
    }
}

Not: Bu kod örneği temel işlevselliği göstermektedir. Projenizde kullanmadan önce, dosya yollarını ve yapılandırma değerlerini gerçek ortamınıza uygun şekilde 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.

Yüksek Çözünürlüklü Çıktı Ayarlarını İnce Ayarlama

Birçok seçenek, oluşturulan JPG dosyalarının kalitesini ve boyutunu kontrol etmenizi sağlar.

• Quality - JPEG sıkıştırma seviyesini (0‑100) belirler. Daha yüksek değerler daha fazla ayrıntıyı korur.

  jpgOptions.setQuality(90);
  

• Resolution - Çıktı görüntüsünün DPI değerini ayarlar. 300 DPI değeri baskıya hazır grafikler için standarttır.

  jpgOptions.setResolution(300);
  

• PageNumber - Çok sayfalı TIFF’in hangi sayfasının dönüştürüleceğini belirtir. Bu değeri bir döngü içinde değiştirmek toplu işleme olanak tanır.

  jpgOptions.setPageNumber(i + 1);
  

API referansında daha gelişmiş senaryolar için setColorMode veya setCompressionLevel gibi ek özellikleri de keşfedebilirsiniz.

Anahtar Çıkarımlar

Java’da TIFF’i JPG’ye dönüştürmek, Conholdate.Total for Java ile oldukça basit hale geliyor. SDK, çok sayfalı TIFF’leri işleyebilir, kalite ve çözünürlüğü ince ayar yapmanıza olanak tanır ve Maven tabanlı projelere sorunsuz bir şekilde entegre olur. Üretim kullanımı için uygun bir lisans almayı unutmayın; fiyatlandırma detayları fiyatlandırma sayfasında ve geçici bir lisans geçici lisans sayfasından temin edilebilir. Sağlanan kod ve yapılandırma ipuçlarıyla, artık herhangi bir Java uygulamasına güvenilir görüntü dönüşümü ekleyebilirsiniz.

Sahip Olabileceğiniz Sorular

Java’da çok sayfalı bir TIFF dosyasını ayrı JPG dosyalarına nasıl dönüştürürüm?
Sayfa sayısını almak için ConversionHandler‘ı kullanın, ardından JpgConvertOptions.setPageNumber ayarını yaparken her sayfada döngü oluşturun. SDK, tam örnekte gösterildiği gibi, her sayfa için bir JPG oluşturacaktır.

Java’da TIFF’ten JPG’ye dönüşüm için hangi performans hususlarını akılda tutmalıyım?
Büyük, yüksek çözünürlüklü TIFF dosyalarının işlenmesi bellek tüketebilir. Tek bir ConversionHandler örneğini yeniden kullanmak ve her çıktı dosyasını hemen yazmak, bellek ayak izini düşük tutmaya yardımcı olur. resolution ve quality değerlerini ayarlamak da işleme süresini azaltabilir.

Ara dosyalar olmadan akış‑tabanlı TIFF’ten JPG’ye dönüşüm yapmanın bir yolu var mı?
Evet. SDK, convert metodunun InputStream ve OutputStream kabul eden aşırı yüklemeleri aracılığıyla akış girişi ve çıkışını destekler. Tam imzalar için API referansı adresine bakın.

Conholdate.Total for Java için daha fazla örnek ve desteği nerede bulabilirim?
Resmi dokümantasyon ayrıntılı kılavuzlar içerir ve topluluk forumları sorular sormak ve çözümler paylaşmak için harika bir yerdir.

Keşfetmeye Devam Edin

• Java’da JPG’yi TIFF’e Dönüştür
• Java’da JPG’yi PNG’e Dönüştür
• Java’da Markdown’ı JPG’ye Dönüştür