使用PDFBox Java在PDF中部绘制图片时位置偏移问题求助

嘿，我懂你现在的头疼事儿——用PDFBox往PDF里加图片，想放到正中心，调了半天位置还是偏的对吧？别慌，咱们先把PDFBox里的坐标逻辑掰明白，这几乎是所有新手踩坑的地方！

首先得明确：PDF的默认坐标原点(0,0)是页面的左下角，而不是咱们直觉里的左上角！这就意味着y轴数值是向上递增的，越往上y值越大。之前你参考的调整原点的方法可能反而绕了弯路，其实直接按这个坐标规则计算居中位置就够了。

下面给你一套修正后的完整代码，每一步都标清楚逻辑：

import java.awt.image.BufferedImage;
import java.io.File;
import java.io.IOException;
import javax.imageio.ImageIO;
import org.apache.pdfbox.pdmodel.PDDocument;
import org.apache.pdfbox.pdmodel.PDPage;
import org.apache.pdfbox.pdmodel.PDPageContentStream;
import org.apache.pdfbox.pdmodel.common.PDRectangle;
import org.apache.pdfbox.pdmodel.graphics.image.PDImageXObject;

public class CenterImageInPdf {
    public static void main(String[] args) {
        try (PDDocument document = new PDDocument()) {
            // 创建A4尺寸的新页面（也可以用自定义尺寸）
            PDPage page = new PDPage(PDRectangle.A4);
            document.addPage(page);
            
            // 替换成你的图片路径
            File imageFile = new File("your-image.png");
            PDImageXObject image = PDImageXObject.createFromFile(imageFile.getAbsolutePath(), document);
            BufferedImage bufferedImage = ImageIO.read(imageFile);
            
            // 获取页面的实际尺寸（PDF单位是"点"，1英寸=72点）
            PDRectangle pageSize = page.getMediaBox();
            float pageWidth = pageSize.getWidth();
            float pageHeight = pageSize.getHeight();
            
            // 把图片的像素尺寸转换成PDF的"点"单位（默认按96DPI计算，你的图片DPI不同就改这里）
            int imageDpi = 96;
            float imageWidth = (bufferedImage.getWidth() * 72f) / imageDpi;
            float imageHeight = (bufferedImage.getHeight() * 72f) / imageDpi;
            
            // 计算居中坐标：水平居中=(页面宽-图片宽)/2；垂直居中=(页面高-图片高)/2
            float centerX = (pageWidth - imageWidth) / 2;
            float centerY = (pageHeight - imageHeight) / 2;
            
            // 写入图片到页面
            try (PDPageContentStream contentStream = new PDPageContentStream(document, page)) {
                // drawImage参数：图片对象、X坐标、Y坐标、图片宽度、图片高度
                contentStream.drawImage(image, centerX, centerY, imageWidth, imageHeight);
            }
            
            // 保存最终PDF
            document.save("centered-image.pdf");
            System.out.println("图片已成功居中添加到PDF！");
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

关键注意点： #

• 坐标计算逻辑：因为原点在左下角，垂直居中的Y坐标是(页面高度-图片高度)/2，这样图片的底部到页面底部的距离，和顶部到页面顶部的距离完全相等，真正实现垂直居中。
• 尺寸单位转换：图片的像素不能直接用在PDF里，必须转换成PDF的"点"单位（1英寸=72点）。如果你的图片DPI不是96，比如是300DPI，就把代码里的imageDpi改成300就行。
• 页面尺寸获取：用page.getMediaBox()获取页面的实际可打印区域，不要用CropBox（除非你明确需要裁剪后的区域）。

你之前可能踩的坑： #

1. 误以为坐标原点在左上角，导致Y坐标计算错误（比如写成pageHeight - centerY - imageHeight，这会把图片往上偏）；
2. 直接用图片的像素数作为PDF里的尺寸，导致图片显示比例不对，位置自然偏移；
3. 错误调整原点，反而把坐标逻辑搞混乱了。

按上面的代码跑一遍，应该就能得到完美居中的图片啦！

内容的提问来源于stack exchange，提问作者shanky