一、相關依賴
<!-- PDFBox for PDF processing --><dependency><groupId>org.apache.pdfbox</groupId><artifactId>pdfbox</artifactId><version>2.0.27</version></dependency>
二、工具類
import org.apache.pdfbox.pdmodel.PDDocument;
import org.apache.pdfbox.pdmodel.common.PDRectangle;
import org.apache.pdfbox.rendering.PDFRenderer;import javax.imageio.ImageIO;
import java.awt.*;
import java.awt.geom.AffineTransform;
import java.awt.geom.Rectangle2D;
import java.awt.image.BufferedImage;
import java.io.File;
import java.io.IOException;
import java.util.ArrayList;
import java.util.List;/*** @ClassName: PdfConvertImage* @Description: PDF文件轉圖片* @Author: zhanghui* @Date: 2025-06-06* @Version: 1.0**/
public class PdfConvertImage {/*** 默認圖片格式*/private static final String DEFAULT_IMAGE_FORMAT = "png";/*** 默認圖片分辨率 - 保持原始比例的高清輸出*/private static final double DEFAULT_SCALE = 2.0;/*** 將多個PDF文件轉換為圖片,使用平衡的高清分辨率* * @param pdfFiles PDF文件列表* @param outputDir 輸出根目錄* @return 生成的圖片路徑列表* @throws Exception 轉換異常*/public static List<String> convertPdfsToImagesWithBalancedResolution(List<File> pdfFiles, String outputDir) throws Exception {// 使用2K分辨率,平衡質量和文件大小return convertPdfsToImagesWithBalancedResolution(pdfFiles, outputDir, 2560, 1440);}/*** 將多個PDF文件轉換為圖片,使用平衡的高清分辨率(可配置)* * @param pdfFiles PDF文件列表* @param outputDir 輸出根目錄* @param targetWidth 目標寬度(推薦:1920-2560)* @param targetHeight 目標高度(推薦:1080-1440)* @return 生成的圖片路徑列表* @throws Exception 轉換異常*/public static List<String> convertPdfsToImagesWithBalancedResolution(List<File> pdfFiles, String outputDir, int targetWidth, int targetHeight) throws Exception {if (pdfFiles == null || pdfFiles.isEmpty()) {throw new IllegalArgumentException("PDF文件列表不能為空");}// 創建項目文件夾String projectDir = createProjectDirectory(outputDir);List<String> allImagePaths = new ArrayList<>();// 處理每個PDF文件for (int i = 0; i < pdfFiles.size(); i++) {File pdfFile = pdfFiles.get(i);if (!pdfFile.exists() || !pdfFile.isFile()) {System.err.println("警告:文件不存在或不是有效文件: " + pdfFile.getPath());continue;}String pdfName = getFileNameWithoutExtension(pdfFile.getName());// 將所有圖片保存到同一個目錄中,通過文件名前綴區分不同的PDFList<String> imagePaths = convertSinglePdfToImagesWithBalancedResolution(pdfFile, projectDir, pdfName, targetWidth, targetHeight);allImagePaths.addAll(imagePaths);}return allImagePaths;}/*** 轉換單個PDF文件為圖片,使用平衡的高清分辨率* * @param pdfFile PDF文件* @param outputDir 輸出目錄* @param pdfNamePrefix PDF名稱前綴,用于區分不同PDF的圖片* @param targetWidth 目標寬度* @param targetHeight 目標高度* @return 生成的圖片路徑列表* @throws Exception 轉換異常*/private static List<String> convertSinglePdfToImagesWithBalancedResolution(File pdfFile, String outputDir, String pdfNamePrefix, int targetWidth, int targetHeight) throws Exception {List<String> imagePaths = new ArrayList<>();try (PDDocument document = PDDocument.load(pdfFile)) {PDFRenderer pdfRenderer = new PDFRenderer(document);int pageCount = document.getNumberOfPages();for (int pageIndex = 0; pageIndex < pageCount; pageIndex++) {// 獲取PDF頁面尺寸PDRectangle pageSize = document.getPage(pageIndex).getBBox();double originalWidth = pageSize.getWidth();double originalHeight = pageSize.getHeight();// 根據原始比例調整目標尺寸double originalRatio = originalWidth / originalHeight;double targetRatio = (double) targetWidth / targetHeight;int finalWidth = targetWidth;int finalHeight = targetHeight;if (originalRatio > targetRatio) {// 原始更寬,以寬度為準finalHeight = (int) Math.round(targetWidth / originalRatio);} else {// 原始更高,以高度為準finalWidth = (int) Math.round(targetHeight * originalRatio);}// 計算縮放比例double scale = Math.min((double) finalWidth / originalWidth, (double) finalHeight / originalHeight);System.out.println("PDF頁面 " + (pageIndex + 1) + " 原始尺寸:" + originalWidth + "x" + originalHeight);System.out.println("目標尺寸:" + finalWidth + "x" + finalHeight);System.out.println("縮放比例:" + String.format("%.2f", scale));// 渲染PDF頁面為圖片BufferedImage image = pdfRenderer.renderImageWithDPI(pageIndex, (float) (scale * 72));// 創建最終尺寸的圖片BufferedImage finalImage = new BufferedImage(finalWidth, finalHeight, BufferedImage.TYPE_INT_RGB);Graphics2D graphics = finalImage.createGraphics();// 設置高質量渲染參數graphics.setRenderingHint(RenderingHints.KEY_ANTIALIASING, RenderingHints.VALUE_ANTIALIAS_ON);graphics.setRenderingHint(RenderingHints.KEY_TEXT_ANTIALIASING, RenderingHints.VALUE_TEXT_ANTIALIAS_ON);graphics.setRenderingHint(RenderingHints.KEY_RENDERING, RenderingHints.VALUE_RENDER_QUALITY);graphics.setRenderingHint(RenderingHints.KEY_INTERPOLATION, RenderingHints.VALUE_INTERPOLATION_BILINEAR);graphics.setRenderingHint(RenderingHints.KEY_FRACTIONALMETRICS, RenderingHints.VALUE_FRACTIONALMETRICS_ON);graphics.setRenderingHint(RenderingHints.KEY_COLOR_RENDERING, RenderingHints.VALUE_COLOR_RENDER_QUALITY);graphics.setRenderingHint(RenderingHints.KEY_STROKE_CONTROL, RenderingHints.VALUE_STROKE_NORMALIZE);// 填充白色背景graphics.setColor(Color.WHITE);graphics.fillRect(0, 0, finalWidth, finalHeight);// 計算居中位置int x = (finalWidth - image.getWidth()) / 2;int y = (finalHeight - image.getHeight()) / 2;// 繪制圖片graphics.drawImage(image, x, y, null);graphics.dispose();// 保存圖片String imagePath = outputDir + File.separator + pdfNamePrefix + "_page_" + (pageIndex + 1) + "." + DEFAULT_IMAGE_FORMAT;File imageFile = new File(imagePath);writeHighQualityImage(finalImage, imageFile, DEFAULT_IMAGE_FORMAT);imagePaths.add(imagePath);// 顯示文件大小信息if (imageFile.exists()) {long fileSizeKB = imageFile.length() / 1024;System.out.println("圖片 " + (pageIndex + 1) + " 大小:" + fileSizeKB + " KB");}}}return imagePaths;}/*** 創建項目目錄* * @param baseDir 基礎目錄* @return 項目目錄路徑*/private static String createProjectDirectory(String baseDir) {String projectDir = baseDir + File.separator;File directory = new File(projectDir);if (!directory.exists()) {directory.mkdirs();}return projectDir;}/*** 獲取不包含擴展名的文件名* * @param fileName 文件名* @return 不包含擴展名的文件名*/private static String getFileNameWithoutExtension(String fileName) {int lastDotIndex = fileName.lastIndexOf('.');if (lastDotIndex > 0) {return fileName.substring(0, lastDotIndex);}return fileName;}/*** 高質量圖片輸出方法* * @param image 要保存的圖片* @param imageFile 輸出文件* @param format 圖片格式* @throws IOException IO異常*/private static void writeHighQualityImage(BufferedImage image, File imageFile, String format) throws IOException {// 使用PNG格式確保無損壓縮,保持原PDF質量if ("png".equalsIgnoreCase(format)) {ImageIO.write(image, format, imageFile);} else {// 如果是其他格式,也使用高質量設置ImageIO.write(image, format, imageFile);}}public static void main(String[] args) {try {// 測試:將多個PDF文件轉換為圖片,所有圖片保存到一個文件夾中String outputDir = "/Users/engine/Desktop/img";List<File> pdfFiles = new ArrayList<>();// 添加你的PDF文件路徑pdfFiles.add(new File("/Users/engine/Desktop/小程序注冊全流程_1749436018969.pdf"));pdfFiles.add(new File("/Users/engine/Desktop/演示文稿1.pdf"));// 使用平衡分辨率方法(推薦:解決文字擠壓且控制文件大小)System.out.println("=== 使用平衡分辨率模式轉換(2K分辨率) ===");List<String> imagePaths = PdfConvertImage.convertPdfsToImagesWithBalancedResolution(pdfFiles, outputDir);System.out.println("=== PDF轉圖片完成 ===");System.out.println("輸出目錄:" + outputDir);System.out.println("轉換模式:平衡分辨率模式(2K分辨率平衡質量與文件大小)");System.out.println("總共生成了 " + imagePaths.size() + " 張圖片:");// 按順序顯示所有圖片路徑(前端輪播可以直接使用這個列表)for (int i = 0; i < imagePaths.size(); i++) {System.out.println((i + 1) + ". " + imagePaths.get(i));}System.out.println("前端輪播提示:");System.out.println("- 所有圖片都在同一個文件夾中");System.out.println("- 圖片命名格式:[PDF文件名]_page_[序號].png");System.out.println("- 可以直接使用返回的圖片路徑列表進行輪播展示");System.out.println("- 圖片采用高質量無損PNG格式,保持原PDF文字布局和顯示效果");System.out.println("- 渲染改進:使用2K分辨率平衡質量與文件大小,解決文字擠壓問題");System.out.println("- 文件大小:每張圖片顯示實際大小,便于監控");} catch (Exception e) {System.err.println("轉換失敗:" + e.getMessage());e.printStackTrace();}}
}