java将pdf文件转换为图片工具类

一、相关依赖

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