Java如何将JPG图片转换为PDF文件？

Question

在使用Java将JPG图片转换为PDF文件时，常见的问题是：如何正确设置图片尺寸以适应PDF页面，避免图像变形或裁剪？许多开发者在使用iText、Apache PDFBox等库时，未根据PDF页面大小（如A4）等比缩放图片，导致输出的图像拉伸或显示不全。此外，JPEG格式的颜色空间处理不当也可能引发图像色彩失真。如何确保图片居中、保持清晰度并自动适配页面尺寸，是实现高质量转换的关键技术难点。

Answer 1

一、背景与常见问题概述

在Java开发中，将JPG图片转换为PDF是文档处理中的高频需求，广泛应用于电子合同生成、报告导出、图像归档等场景。然而，开发者常遇到的关键问题包括：图片尺寸未适配PDF页面导致拉伸变形、图像被裁剪、居中对齐失效以及JPEG颜色空间处理不当引发的色彩失真。

尤其在使用主流库如iText或Apache PDFBox时，若未正确计算缩放比例和坐标偏移，输出结果往往不符合预期。以下从基础到深入逐步解析该技术难点。

二、核心挑战分析

• 图像变形：未保持宽高比进行缩放，直接设置固定宽度和高度。
• 裁剪问题：图片超出页面边界，未做边界检测与自动调整。
• 居中失败：定位计算错误，未基于页面中心动态计算x/y坐标。
• 色彩失真：JPEG使用CMYK颜色空间而PDF默认期望RGB，未做转换。
• 清晰度下降：压缩参数设置不合理或重采样方式不当。

三、技术实现路径（以iText为例）

使用iText 7进行图片转PDF的核心流程如下：

1. 读取JPG文件并创建ImageData对象。
2. 初始化Document和PdfWriter。
3. <3>获取目标页面尺寸（如A4: 595.28 x 841.89 用户单位）。</3>
4. 计算图片缩放比例，保持宽高比。
5. 确定居中位置的x/y偏移量。
6. 将Image添加至文档。
7. 关闭资源流。

四、关键算法：等比缩放与居中定位

为避免图像变形，必须按最小缩放因子统一缩放：

// 示例代码：计算适配A4页面的缩放后尺寸
float pageWidth = 595.28f;
float pageHeight = 841.89f;
float imgWidth = image.getImageWidth();
float imgHeight = image.getImageHeight();

float scaleWidth = pageWidth / imgWidth;
float scaleHeight = pageHeight / imgHeight;
float scale = Math.min(scaleWidth, scaleHeight); // 等比缩放

float scaledWidth = imgWidth * scale;
float scaledHeight = imgHeight * scale;

// 居中坐标
float x = (pageWidth - scaledWidth) / 2;
float y = (pageHeight - scaledHeight) / 2;
    

五、颜色空间处理：防止色彩失真

JPEG可能包含CMYK数据，而PDF标准渲染依赖RGB。需提前转换：

颜色模式	适用场景	处理建议
RGB	屏幕显示、网页、大多数PDF	直接嵌入
CMYK	印刷用途	转换为RGB或指定PDF色彩空间
Grayscale	黑白文档	保留灰度信息

六、完整iText实现示例

public void convertJpgToPdf(String jpgPath, String pdfPath) throws IOException {
    PdfWriter writer = new PdfWriter(pdfPath);
    PdfDocument pdfDoc = new PdfDocument(writer);
    Document document = new Document(pdfDoc, PageSize.A4);

    ImageData imageData = ImageDataFactory.create(jpgPath);
    Image image = new Image(imageData);

    float pageWidth = pdfDoc.getDefaultPageSize().getWidth();
    float pageHeight = pdfDoc.getDefaultPageSize().getHeight();
    float imgWidth = imageData.getWidth();
    float imgHeight = imageData.getHeight();

    float scale = Math.min(pageWidth / imgWidth, pageHeight / imgHeight);
    float x = (pageWidth - imgWidth * scale) / 2;
    float y = (pageHeight - imgHeight * scale) / 2;

    image.setFixedPosition(x, y);
    image.scaleAbsolute(imgWidth * scale, imgHeight * scale);
    document.add(image);

    document.close();
}
    

七、Apache PDFBox对比实现

PDFBox实现逻辑类似，但API略有差异：

PDDocument doc = new PDDocument();
PDPage page = new PDPage(PDRectangle.A4);
doc.addPage(page);

PDImageXObject image = PDImageXObject.createFromFile(jpgPath, doc);
float scale = Math.min(
    page.getMediaBox().getWidth() / image.getWidth(),
    page.getMediaBox().getHeight() / image.getHeight()
);

try (PDPageContentStream contents = new PDPageContentStream(doc, page)) {
    float x = (page.getMediaBox().getWidth() - image.getWidth() * scale) / 2;
    float y = (page.getMediaBox().getHeight() - image.getHeight() * scale) / 2;

    contents.drawImage(image, x, y, image.getWidth() * scale, image.getHeight() * scale);
}
doc.save(pdfPath);
doc.close();
    

八、高级优化建议

为进一步提升质量，可考虑以下策略：

• 使用ImageFormat.PNG临时转换以规避JPEG解码问题。
• 启用抗锯齿渲染选项（适用于PDFBox）。
• 设置DPI元数据确保打印清晰度。
• 批量处理时采用流式写入避免内存溢出。
• 预校验图片EXIF方向信息并自动旋转纠正。

九、流程图：图片转PDF处理逻辑

graph TD
            A[加载JPG文件] --> B{是否为CMYK?}
            B -- 是 --> C[转换为RGB]
            B -- 否 --> D[解析原始尺寸]
            C --> D
            D --> E[获取PDF页面尺寸]
            E --> F[计算等比缩放因子]
            F --> G[计算居中坐标]
            G --> H[创建PDF文档]
            H --> I[插入缩放后图像]
            I --> J[保存并关闭]

十、跨库兼容性与测试建议

不同库对图像编码支持存在差异，推荐建立统一抽象层：

库	优点	缺点	适用场景
iText 7	高性能、功能丰富、支持HTML转PDF	商业授权复杂	企业级文档生成
PDFBox	开源免费、Apache许可	图像处理略弱	中小型项目、内部系统