نیازمندی‌های تبدیل TIFF به JPG در Java

برنامه‌های Java که اسناد اسکن‌شده، تصاویر پزشکی یا عکاسی ماهواره‌ای را پردازش می‌کنند، اغلب ورودی را به صورت فایل‌های TIFF چندصفحه‌ای دریافت می‌نمایند. تبدیل باید جزئیات را حفظ کند، خروجی با وضوح بالا را پشتیبانی کند و برای هر صفحه یک فایل JPG جداگانه تولید کند تا پردازش‌های بعدی ساده‌تر شود. ابزارهای تبدیل دستی قابل اسکریپت‌نویسی نیستند و مقیاس‌پذیر نیستند، به‌طوری‌که داشتن یک کتابخانه خودکار برای سناریوهای دسته‌ای یا زمان واقعی ضروری است.

چگونه Conholdate.Total for Java تبدیل TIFF به JPG را در جاوا انجام می‌دهد

Conholdate.Total for Java یک موتور تبدیل اختصاصی ارائه می‌دهد که فرمت TIFF را، از جمله تصاویر چندصفحه‌ای، می‌فهمد و می‌تواند خروجی JPG با کیفیت بالا تولید کند. SDK به شما امکان تنظیم کیفیت خروجی، وضوح DPI و انتخاب صفحه را می‌دهد که نیاز به کنترل دقیق بر وفاداری تصویر را برآورده می‌کند. مستندات و مراجع API برای راهنمایی شما در هر ویژگی موجود است: به مستندات رسمی و مرجع API مراجعه کنید. با یک وابستگی ساده Maven، کتابخانه به‌صورت یکپارچه در هر پروژه Java ادغام می‌شود.

اجرای تبدیل TIFF به JPG در جاوا

مراحل زیر شما را در تنظیم پروژه، مقداردهی اولیه SDK و انجام تبدیل راهنمایی می‌کند.

افزودن وابستگی Maven برای Conholdate.Total

مخزن Maven Conholdate و وابستگی SDK را در فایل pom.xml خود اضافه کنید. این اطمینان می‌دهد که کتابخانه در زمان کامپایل در دسترس باشد.

<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>

می‌توانید آخرین نسخه را از صفحه دانلود دریافت کنید.

مقداردهی اولیه ConversionHandler

یک نمونه از ConversionHandler ایجاد کنید. SDK فرض می‌کند که یک لایسنس معتبر در جای دیگری از برنامه شما تنظیم شده است.

ConversionHandler conversionHandler = new ConversionHandler();

برای گزینه‌های اضافی مقداردهی اولیه به کلاس ConversionHandler مراجعه کنید.

بارگیری فایل TIFF و دریافت تعداد صفحات

از LoadOptions و getFileInfo برای دریافت اطلاعات دربارهٔ TIFF منبع، از جمله تعداد صفحات، استفاده کنید.

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

این گام برای ابزار تبدیل TIFF به JPG در Java ضروری است، زیرا پردازش صفحه به صفحه را امکان‌پذیر می‌کند.

پیکربندی گزینه‌های تبدیل JPG

کیفیت، وضوح و صفحه خاصی که می‌خواهید تبدیل کنید را تنظیم کنید. این تنظیمات بخشی از جریان کاری تبدیل TIFF با وضوح بالا به JPG در جاوا هستند.

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

اجرای حلقه تبدیل و اعتبارسنجی خروجی

در هر صفحه تکرار کنید، تبدیل را انجام دهید و تأیید کنید که فایل JPG حاصل وجود دارد.

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));
    }
}

این تبدیل دسته‌ای TIFF به JPG در جاوا را با حداقل کد نشان می‌دهد.

مثال کامل کد: تبدیل TIFF به JPG با خروجی با وضوح بالا

کد زیر پیاده‌سازی کامل توصیف‌شده در بالا را نشان می‌دهد.

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();
        }
    }
}

Note: این مثال کد عملکرد اصلی را نشان می‌دهد. قبل از استفاده از آن در پروژه‌تان، اطمینان حاصل کنید که مسیرهای فایل و مقادیر پیکربندی را به‌گونه‌ای به‌روزرسانی کنید که با محیط واقعی شما مطابقت داشته باشد، بررسی کنید که تمام وابستگی‌های مورد نیاز به‌درستی نصب شده‌اند و به‌طور کامل در محیط توسعه خود تست کنید. اگر با مشکلی مواجه شدید، لطفاً به مستندات رسمی مراجعه کنید یا برای دریافت کمک با تیم پشتیبانی تماس بگیرید.

تنظیم دقیق تنظیمات خروجی با وضوح بالا

چند گزینه به شما امکان می‌دهند کیفیت و اندازه فایل‌های JPG تولید شده را کنترل کنید.

• Quality - تعیین می‌کند سطح فشرده‌سازی JPEG (0‑100). مقادیر بالاتر جزئیات بیشتری را حفظ می‌کنند.

jpgOptions.setQuality(90);

• Resolution - DPI تصویر خروجی را تنظیم می‌کند. مقدار 300 DPI استاندارد برای گرافیک‌های آماده چاپ است.

jpgOptions.setResolution(300);

• PageNumber - مشخص می‌کند کدام صفحه از یک TIFF چندصفحه‌ای تبدیل شود. تغییر این مقدار درون یک حلقه امکان پردازش دسته‌ای را فراهم می‌کند.

jpgOptions.setPageNumber(i + 1);

شما همچنین می‌توانید ویژگی‌های اضافی مانند setColorMode یا setCompressionLevel را در مرجع API برای سناریوهای پیشرفته‌تر بررسی کنید.

نکات کلیدی

تبدیل TIFF به JPG در جاوا با Conholdate.Total for Java به سادگی انجام می‌شود. SDK می‌تواند TIFFهای چندصفحه را مدیریت کند، به شما امکان تنظیم دقیق کیفیت و وضوح را می‌دهد و به‌صورت یکپارچه در پروژه‌های مبتنی بر Maven ادغام می‌شود. به‌خاطر داشته باشید که برای استفاده در محیط تولید یک لایسنس مناسب دریافت کنید؛ جزئیات قیمت‌گذاری در صفحه قیمت‌گذاری موجود است و یک لایسنس موقت از صفحه لایسنس موقت قابل دریافت است. با کدها و نکات پیکربندی ارائه‌شده، اکنون می‌توانید تبدیل تصویر قابل اعتماد را به هر برنامه جاوا اضافه کنید.

سؤالاتی که ممکن است داشته باشید

چگونه یک فایل TIFF چندصفحه‌ای را به فایل‌های JPG جداگانه در جاوا تبدیل کنم؟
Use the ConversionHandler to retrieve the page count, then loop through each page while setting JpgConvertOptions.setPageNumber. The SDK will generate one JPG per page, as shown in the complete example.

در هنگام تبدیل TIFF به JPG در جاوا چه ملاحظات عملکردی باید در نظر بگیرم؟
Processing large, high‑resolution TIFFs can consume memory. Reusing a single ConversionHandler instance and writing each output file immediately helps keep the memory footprint low. Adjusting the resolution and quality values can also reduce processing time.

آیا راهی برای انجام تبدیل TIFF به JPG به‌صورت جریان‌محور بدون فایل‌های میانی وجود دارد؟
بله. SDK از ورودی و خروجی جریان‌دار از طریق overloadهای متد convert که InputStream و OutputStream را می‌پذیرند، پشتیبانی می‌کند. برای امضای دقیق به API reference مراجعه کنید.

کجا می‌توانم مثال‌ها و پشتیبانی بیشتری برای Conholdate.Total for Java پیدا کنم؟
مستندات رسمی مستندات شامل راهنمایی‌های دقیق است و انجمن‌های جامعه انجمن‌ها مکان خوبی برای پرسش سوالات و به اشتراک‌گذاری راه‌حل‌ها هستند.

به کاوش ادامه دهید

• تبدیل JPG به TIFF در جاوا
• تبدیل JPG به PNG در جاوا
• تبدیل Markdown به JPG در جاوا