ตัวอย่างทำงานเต็มสำหรับการแปลง PDF เป็น PNG ใน Java ด้วย Conholdate.Total

ตัวอย่างนี้แสดงวิธีการแปลง PDF เป็น PNG ใน Java โดยใช้ API การแปลงของ Conholdate.Total.

import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PngConvertOptions;

import java.io.FileInputStream;
import java.io.InputStream;
import java.util.ArrayList;
import java.util.List;
import java.util.concurrent.*;

public class PdfToPngDemo {
    private static final String INPUT_PDF = "input.pdf";
    private static final String OUTPUT_PATTERN = "output_page_%d.png";

public static void main(String[] args) throws Exception {
        long start = System.nanoTime();

// Determine page count without loading whole document into memory
        int totalPages;
        try (InputStream is = new FileInputStream(INPUT_PDF)) {
            Converter tempConverter = new Converter(is);
            totalPages = tempConverter.getPageCount();
        }

// Thread pool sized to available processors
        ExecutorService executor = Executors.newFixedThreadPool(Runtime.getRuntime().availableProcessors());
        List<Future<?>> tasks = new ArrayList<>();

for (int page = 1; page <= totalPages; page++) {
            final int pageNumber = page;
            tasks.add(executor.submit(() -> {
                // Each thread creates its own Converter instance – ensures thread safety
                try (InputStream pdfStream = new FileInputStream(INPUT_PDF)) {
                    Converter converter = new Converter(pdfStream);

PngConvertOptions options = new PngConvertOptions();
                    options.setPageNumber(pageNumber);          // convert single page
                    options.setResolution(150);                 // memory‑friendly DPI
                    options.setQuality(90);                     // PNG compression quality (0‑100)

String outputPath = String.format(OUTPUT_PATTERN, pageNumber);
                    converter.convert(outputPath, options);
                } catch (Exception e) {
                    throw new RuntimeException("Failed to convert page " + pageNumber, e);
                }
            }));
        }

// Wait for all conversions to finish
        for (Future<?> f : tasks) {
            f.get(); // re‑throws any exception from the task
        }

executor.shutdown();

long end = System.nanoTime();
        System.out.printf("PDF to PNG conversion completed in %.2f seconds.%n",
                (end - start) / 1_000_000_000.0);
    }
}

หมายเหตุ: ตัวอย่างโค้ดนี้แสดงการทำงานหลัก ก่อนนำไปใช้ในโครงการของคุณ โปรดตรวจสอบให้แน่ใจว่าได้อัปเดตเส้นทางไฟล์และค่าการกำหนดค่าต่าง ๆ ให้ตรงกับสภาพแวดล้อมจริงของคุณ ตรวจสอบว่าขึ้นตอนการพึ่งพาที่จำเป็นทั้งหมดได้ติดตั้งอย่างถูกต้องแล้ว และทำการทดสอบอย่างละเอียดในสภาพแวดล้อมการพัฒนา หากคุณพบปัญหาใด ๆ โปรดดูที่ เอกสารอย่างเป็นทางการ หรือ ติดต่อ ทีมสนับสนุน เพื่อขอความช่วยเหลือ

ทำความเข้าใจการแปลง PDF เป็น PNG ด้วยโค้ด Java

จุดต่อไปนี้แยกแยะขั้นตอนการทำงานของโปรแกรมตัวอย่าง:

1. โหลด PDF และกำหนดจำนวนหน้า - คลาส Converter ถูกสร้างด้วย InputStream ที่ชี้ไปยัง PDF ต้นฉบับ การเรียก getPageCount() จะดึงจำนวนหน้าทั้งหมดโดยไม่ต้องโหลดเอกสารทั้งหมดเข้าสู่หน่วยความจำ.

try (InputStream is = new FileInputStream(INPUT_PDF)) {
    Converter tempConverter = new Converter(is);
    totalPages = tempConverter.getPageCount();
}

2. สร้าง Thread Pool สำหรับการประมวลผลแบบขนาน - ExecutorService ที่มีขนาดตามจำนวนโปรเซสเซอร์ที่มีอยู่ทำงานงานแปลงแบบพร้อมกัน เพิ่มประสิทธิภาพการทำงานโดยรวม.

   ExecutorService executor = Executors.newFixedThreadPool(Runtime.getRuntime().availableProcessors());
   

3. กำหนดค่าตัวเลือกการแปลงตามหน้าที่เฉพาะ - ภายในแต่ละงานจะสร้างอินสแตนซ์ Converter ใหม่ (เพื่อรับประกันความปลอดภัยของเธรด). PngConvertOptions ให้คุณตั้งค่าหน้าปลายทาง, ความละเอียด, และคุณภาพ PNG.

   PngConvertOptions options = new PngConvertOptions();
   options.setPageNumber(pageNumber);
   options.setResolution(150);
   options.setQuality(90);
   

4. ดำเนินการแปลงและเขียนไฟล์ PNG - วิธี convert จะเขียนไฟล์ PNG ผลลัพธ์โดยใช้ชื่อไฟล์ที่จัดรูปแบบซึ่งรวมหมายเลขหน้าไว้

String outputPath = String.format(OUTPUT_PATTERN, pageNumber);
converter.convert(outputPath, options);

5. ประสานการเสร็จสิ้นและทำความสะอาด - เธรดหลักจะรอให้ทุก futures เสร็จสิ้น จากนั้นปิดการทำงานของ executor และพิมพ์เวลาที่ใช้ไป แพทเทิร์นนี้รับประกันว่าทุกหน้าได้รับการประมวลผลก่อนที่โปรแกรมจะออก.

สำหรับรายละเอียด API ที่ลึกขึ้น โปรดปรึกษา Conholdate.Total Java API Reference.

เตรียมสภาพแวดล้อมให้พร้อม

เพิ่มที่เก็บ Maven ของ Conholdate.Total และการพึ่งพาใน 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>

ดาวน์โหลดแพ็กเกจ SDK ล่าสุดจาก หน้าดาวน์โหลดอย่างเป็นทางการ. ไลบรารีต้องการ Java 8 หรือสูงกว่าและทำงานบน JVM มาตรฐานใดก็ได้.

การกำหนดค่าการแปลง

โค้ดตัวอย่างแสดงตัวเลือกสำคัญสามอย่างที่คุณสามารถปรับแต่งได้:

• Page Number - options.setPageNumber(pageNumber); เลือกหน้าที่ต้องการเรนเดอร์.
• Resolution - options.setResolution(150); ควบคุม DPI. ค่าที่สูงขึ้นจะเพิ่มรายละเอียดแต่ใช้หน่วยความจำมากขึ้น.
• Quality - options.setQuality(90); ตั้งค่าการบีบอัด PNG (0‑100). ปรับค่านี้เพื่อสมดุลขนาดไฟล์และคุณภาพภาพ.

หากคุณต้องการการควบคุมเพิ่มเติม, เอกสารอ้างอิง API ระบุคุณสมบัติอื่น ๆ เช่น setColorMode และ setBackgroundColor

แนวทางปฏิบัติที่ดีที่สุดสำหรับการแปลง PDF เป็น PNG อย่างมีประสิทธิภาพ

• สตรีมหน้าแยกกัน - ประมวลผลแต่ละหน้าจาก InputStream เพื่อหลีกเลี่ยงการโหลด PDF ทั้งไฟล์เข้าสู่หน่วยความจำ.
• ใช้พูลเธรดขนาดคงที่ - การกำหนดขนาดพูลให้เท่ากับ Runtime.getRuntime().availableProcessors() จะป้องกันการสับสนของเธรดขณะเพิ่มประสิทธิภาพการใช้ CPU ให้สูงสุด.
• ตั้งค่า DPI ปานกลาง - สำหรับสถานการณ์การแสดงตัวอย่างส่วนใหญ่, 150 DPI ให้ความสมดุลที่ดีระหว่างคุณภาพและประสิทธิภาพ.
• ใช้ตัวแปลงซ้ำอย่างระมัดระวัง - การสร้าง Converter ใหม่ต่อเธรดจะรับประกันความปลอดภัยของเธรด; การแชร์อินสแตนซ์เดียวกันอาจทำให้เกิดสภาวะการแข่งขัน.
• วัดเวลาในการดำเนินการ - ตัวอย่างนี้พิมพ์จำนวนวินาทีที่ใช้; ใช้ข้อมูลนี้เพื่อปรับแต่งความละเอียดหรือจำนวนเธรดให้เหมาะกับภาระงานของคุณ.

สรุป

การแปลง PDF เป็น PNG ใน Java เป็นการดำเนินการที่ทำบ่อยแต่ต้องคำนึงถึงประสิทธิภาพ ด้วย Conholdate.Total for Java, คุณจะได้รับ SDK ที่ครบถ้วนซึ่งจัดการการสตรีมหน้า‑ต่อหน้า, การทำงานหลายเธรด, และตัวเลือกภาพที่ละเอียด ตัวอย่างข้างต้นแสดงวิธีสร้างยูทิลิตี้การแปลง PDF เป็น PNG ที่สามารถขยายได้, ตั้งค่าความละเอียดและคุณภาพ, และลดการใช้หน่วยความจำให้ต่ำ จำไว้ว่าให้รับใบอนุญาตที่ถูกต้องสำหรับการใช้งานในผลิตภัณฑ์; คุณสามารถขอใบอนุญาตชั่วคราวได้ที่ https://purchase.conholdate.com/temporary-license/ และตรวจสอบตัวเลือกการกำหนดราคาได้ที่ https://purchase.conholdate.com/pricing/total/family/. ผสานรวมโค้ด, ปรับการตั้งค่าให้ตรงกับความต้องการของคุณ, และมอบภาพตัวอย่างที่เร็วและเชื่อถือได้จากเอกสาร PDF ใด ๆ

คำถามทั่วไป

• ฉันจะแปลง PDF เป็น PNG ใน Java โดยไม่ใช้เครื่องมือภายนอกได้อย่างไร?
  SDK ทำการแปลงทั้งหมดในโค้ด ดังนั้นคุณไม่จำเป็นต้องใช้ยูทิลิตี้บรรทัดคำสั่งของบุคคลที่สาม เพียงเพิ่มการพึ่งพา Maven แล้วใช้คลาส Converter ตามที่แสดง

• ฉันคาดว่าจะได้ประสิทธิภาพอย่างไรจากยูทิลิตี้การแปลง PDF เป็น PNG ใน Java?
  โดยการประมวลผลหน้าแบบขนานและใช้ DPI ปานกลาง (เช่น 150) ตัวอย่างจะทำการแปลง PDF 50‑หน้าได้ภายในไม่กี่วินาทีบนซีพียูสมัยใหม่ คุณสามารถทำการทดสอบความเร็วของไฟล์ของคุณเองได้โดยวัดเวลาในการทำงานที่โปรแกรมพิมพ์ออกมา

• ฉันสามารถแปลง PDF ที่มีรูปภาพความละเอียดสูงจำนวนมากโดยไม่ทำให้หน่วยความจำหมดได้หรือไม่?
  ใช่. โค้ดจะสตรีมแต่ละหน้าแยกกันและทำการปล่อย InputStream หลังจากการแปลงซึ่งช่วยให้ขนาดของ heap เล็กลง หากคุณพบปัญหาหน่วยความจำ ให้ปรับความละเอียดหรือใช้จำนวนเธรดน้อยลง.

• สามารถปรับแต่งผลลัพธ์ PNG ได้เพิ่มเติมหรือไม่ เช่น การเปลี่ยนสีพื้นหลัง?
  ตัวเลือกเพิ่มเติมมีใน PngConvertOptions. ดูที่ อ้างอิง API สำหรับคุณสมบัติเช่น setBackgroundColor และ setColorMode.

บทความที่เกี่ยวข้อง

• แปลง JPG เป็น PNG ใน Java
• แปลง CDR เป็น PNG ใน Java
• แปลง PDF เป็น Grayscale ใน Java