如何基于像素值在PDFBox中精准计算表单域的坐标与宽高

你的偏移问题核心是PDF坐标系统与像素坐标系统的差异，以及未正确处理像素到PDF用户单位的转换：

• PDF默认坐标原点在页面左下角，Y轴向上；而你的输入是左上角为原点的像素坐标，Y轴向下
• PDF使用「用户单位」（默认1单位=1/72英寸），需要将像素值按DPI转换为用户单位
• 页面旋转会进一步影响坐标映射，若未处理会导致偏移随页面布局加剧

以下是修正后的代码，重点优化坐标转换逻辑，确保像素坐标精准映射到PDF位置：

private void addField(PDDocument document, PDAcroForm acroForm, DocumentMemberConfigDto config) throws IOException {
    PDTextField textBox = new PDTextField(acroForm);
    textBox.setPartialName(config.id);

    String fontName = getFontName(document, config);
    long fontSize = config.FontSize > 0 ? config.FontSize : 12; // 修复变量名拼写错误：FondSize → FontSize

    String colorString = colorToRGBString(config.Fill);
    String defaultAppearanceString = String.format("/%s %d Tf %s",
            fontName,
            fontSize,
            colorString);

    logger.info("default appearance of field : " + config.id + "  " + defaultAppearanceString);
    textBox.setDefaultAppearance(defaultAppearanceString);

    // 添加字段到表单
    acroForm.getFields().add(textBox);
    int targetPageIndex = getNumPageFromConfig(config);
    PDPage page = document.getPage(targetPageIndex);

    // --- 核心：像素坐标转PDF坐标 ---
    // 1. 定义DPI（通常屏幕显示用96DPI，打印可调整为300DPI，根据需求修改）
    final int DPI = 96;
    // 2. 获取页面实际尺寸（考虑旋转，转换为未旋转的媒体盒尺寸）
    PDRectangle mediaBox = page.getMediaBox();
    PDRectangle adjustedMediaBox = getAdjustedMediaBox(page, mediaBox);
    float pageWidth = adjustedMediaBox.getWidth();
    float pageHeight = adjustedMediaBox.getHeight();

    // 3. 像素转PDF用户单位：1像素 = 72/DPI 用户单位
    float pdfX = config.X * 72f / DPI;
    float pdfYFromTop = config.Y * 72f / DPI;
    float pdfWidth = config.W * 72f / DPI;
    float pdfHeight = config.H * 72f / DPI;

    // 4. 转换Y坐标：PDF原点在左下角，需从页面高度减去顶部距离和字段高度
    float pdfY = pageHeight - pdfYFromTop - pdfHeight;

    // 5. 处理页面旋转，修正最终坐标
    PDRectangle fieldRect = adjustRectForRotation(page, new PDRectangle(pdfX, pdfY, pdfWidth, pdfHeight), adjustedMediaBox);

    // --- 设置表单域部件 ---
    PDAnnotationWidget widget = textBox.getWidgets().get(0);
    widget.setRectangle(fieldRect);
    widget.setPage(page);
    widget.setPrinted(true);
    page.getAnnotations().add(widget);

    // 设置文本对齐
    textBox.setQ(PDVariableText.QUADDING_LEFT);
}

// 辅助方法：获取考虑页面旋转后的媒体盒尺寸
private PDRectangle getAdjustedMediaBox(PDPage page, PDRectangle mediaBox) {
    int rotation = page.getRotation();
    if (rotation == 90 || rotation == 270) {
        // 旋转90/270度时，宽高互换
        return new PDRectangle(mediaBox.getHeight(), mediaBox.getWidth());
    }
    return mediaBox;
}

// 辅助方法：根据页面旋转修正表单域坐标
private PDRectangle adjustRectForRotation(PDPage page, PDRectangle rect, PDRectangle adjustedMediaBox) {
    int rotation = page.getRotation();
    float pageWidth = adjustedMediaBox.getWidth();
    float pageHeight = adjustedMediaBox.getHeight();

    switch (rotation) {
        case 90:
            // 顺时针旋转90度：原(x,y) → (y, pageWidth - x - width)
            return new PDRectangle(
                    rect.getLowerLeftY(),
                    pageWidth - rect.getLowerLeftX() - rect.getWidth(),
                    rect.getHeight(),
                    rect.getWidth()
            );
        case 180:
            // 顺时针旋转180度：原(x,y) → (pageWidth - x - width, pageHeight - y - height)
            return new PDRectangle(
                    pageWidth - rect.getLowerLeftX() - rect.getWidth(),
                    pageHeight - rect.getLowerLeftY() - rect.getHeight(),
                    rect.getWidth(),
                    rect.getHeight()
            );
        case 270:
            // 顺时针旋转270度：原(x,y) → (pageHeight - y - height, x)
            return new PDRectangle(
                    pageHeight - rect.getLowerLeftY() - rect.getHeight(),
                    rect.getLowerLeftX(),
                    rect.getHeight(),
                    rect.getWidth()
            );
        default: // 0度，无需调整
            return rect;
    }
}

1. 坐标系统转换：
   • 将像素坐标按72/DPI比例转换为PDF用户单位（72是PDF默认的每英寸点数）
   • Y坐标从「左上角原点」转换为「左下角原点」：pdfY = 页面高度 - 顶部像素转换值 - 字段高度
2. 页面旋转处理：
   • 自动识别页面旋转角度（90/180/270度），修正表单域的位置和宽高，避免旋转页面上的偏移
3. 变量名修复：
   • 修正原代码中的拼写错误FondSize→FontSize，避免逻辑错误

• DPI值可根据实际场景调整：如果是屏幕显示用96DPI，打印输出建议用300DPI
• 若使用裁剪盒（CropBox）而非媒体盒（MediaBox），需将getMediaBox()替换为getCropBox()，确保坐标基于实际可见页面范围

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