本文详解如何利用 openpdf 的 `pdfstamper` 与页面覆层（over content）机制，将印章等图像精确、动态地叠加在 pdf 文本上方，支持绝对定位与分页适配，满足合同签署等实际业务需求。
在 OpenPDF 中，Image 类内置的定位常量（如 UNDERLYING、TEXTWRAP、LEFT 等）仅适用于文档构建阶段（即通过 Document.add() 插入图像），且均无法实现“图像覆盖在已有文本之上”的视觉效果——这正是电子合同加盖公章、签名章等典型场景的核心需求。关键在于：浮层印章不属于文档流内容，而应作为独立图层绘制在页面最上层。
OpenPDF 提供了成熟可靠的解决方案：使用 PdfStamper 对已有 PDF 进行编辑，并通过其 getOverContent(int page) 方法获取指定页的覆层画布（PdfContentByte）。该画布默认位于页面所有内容（包括正文、表格、原有图像）的顶层，因此在其上绘制的图像天然“浮于文字之上”，且支持像素级绝对坐标控制。
✅ 正确实现步骤（含代码示例）
import com.lowagie.text.Image;
import com.lowagie.text.pdf.PdfContentByte;
import com.lowagie.text.pdf.PdfReader;
import com.lowagie.text.pdf.PdfStamper;
import java.io.FileOutputStream;
import java.io.IOException;
public class SealOverlayExample {
public static void addSealToPage(String srcPdf, String destPdf, String sealImagePath,
float x, float y, float width, float height, int page)
throws IOException {
PdfReader reader = new PdfReader(srcPdf);
PdfStamper stamper = new PdfStamper(reader, new FileOutputStream(destPdf));
// 获取目标页的覆层（OVER CONTENT），确保图像绘制在最上层
PdfContentByte overContent = stamper.getOverContent(page);
// 加载印章图像并设置尺寸与位置（坐标原点为左下角，y 向上为正）
Image seal = Image.getInstance(sealImagePath);
seal.scaleAbsolute(width, height);
seal.setAbsolutePosition(x, y); // x: 距左边界距离；y: 距底边界距离
// 将图像写入覆层
overContent.addImage(seal);
stamper.close();
reader.close();
}
// 示例调用：在第1页 (page=1) 左上区域添加 80×80 像素印章
public static void main(String[] args) throws Exception {
addSealToPage(
"contract.pdf",
"contract_with_seal.pdf",
"seal.png",
450f, // x = 距左边界 450 单位（1 unit ≈ 1/72 inch）
750f, // y = 距底边界 750 单位 → 实际显示在页面顶部偏右位置
80f, // 宽度
80f, // 高度
1 // 第1页
);
}
}⚠️ 关键注意事项
- 坐标系理解：OpenPDF 使用 PDF 标准坐标系——原点 (0, 0) 在页面左下角，y 轴向上增长。若需将印章置于“右下角”，x 应接近 pageWidth，y 应接近 0；置于“右上角”则 x 接近 pageWidth，y 接近 pageHeight。
- 动态定位策略：因合同正文长度可变，建议结合 PdfReader 获取页面尺寸（reader.getPageSize(page).getWidth()/getHeight()），再按比例计算坐标（如 x = pageWidth - 120f, y = pageHeight - 100f），或解析文本块位置（需配合 PdfTextExtractor 或 LocationTextExtractionStrategy）实现智能锚定。
- 分页处理：PdfStamper 支持逐页操作。若印章需跨多页（如每页页脚加盖骑缝章），需循环调用 getOverContent(i) 并分别绘制。
- 图像格式兼容性：推荐使用 PNG（支持透明背景）或 JPEG。确保路径有效，且图像资源已正确加载（Image.getInstance(...) 可能抛出 IOException）。
- 性能与内存：PdfStamper 会加载整个 PDF 到内存，处理大型文件时注意 JVM 堆配置；操作完成后务必调用 stamper.close() 和 reader.close() 释放资源。
✅ 总结
OpenPDF 本身不提供 Image.OVERLAY 这类语义化常量，但通过 PdfStamper#getOverContent() 这一底层机制，开发者可完全掌控图像的渲染层级与空间位置。该方案不仅满足“印章浮于文字之上”的刚性需求，更具备高精度、可编程、易集成的特点，是电子签章、PDF 批注、水印嵌入等场景的标准实践路径。
