IText PDF簽章時如何獲取PDF頁的坐標

# IText PDF簽章時如何獲取PDF頁的坐標

## 前言

在數字化文檔處理中，PDF電子簽章是實現文檔認證和防篡改的重要技術手段。當使用iText庫進行PDF簽章操作時，精確定位簽章位置是開發中的核心需求之一。本文將深入探討如何通過iText獲取PDF頁面坐標系統，并實現精準的簽章定位。

## 一、PDF坐標系統基礎

### 1.1 坐標系定義

PDF采用**二維笛卡爾坐標系**，具有以下特點：
- 原點(0,0)默認位于頁面左下角
- X軸向右延伸，Y軸向上延伸
- 基本單位為**1/72英寸**（約0.3528毫米）

```java
// 坐標系示例
PdfDocument pdfDoc = new PdfDocument(new PdfReader("input.pdf"));
PdfPage page = pdfDoc.getPage(1);
Rectangle mediabox = page.getMediaBox();
System.out.println("頁面尺寸: " + mediabox.getWidth() + "×" + mediabox.getHeight());

1.2 常見頁面尺寸對應坐標

二、獲取頁面區域信息

2.1 關鍵區域對象

iText提供了多個獲取頁面區域的API：

// 獲取各種頁面框
Rectangle mediaBox = page.getMediaBox();  // 物理頁面大小
Rectangle cropBox = page.getCropBox();   // 顯示/打印區域
Rectangle bleedBox = page.getBleedBox(); // 出血區域
Rectangle trimBox = page.getTrimBox();   // 成品尺寸

2.2 坐標轉換場景

當需要處理旋轉頁面時，必須進行坐標轉換：

int rotation = page.getRotation();
if (rotation != 0) {
    AffineTransform transform = new AffineTransform();
    // 根據旋轉角度調整坐標系
    switch (rotation) {
        case 90:
            transform.translate(0, mediabox.getHeight());
            break;
        case 180:
            transform.translate(mediabox.getWidth(), mediabox.getHeight());
            break;
        case 270:
            transform.translate(mediabox.getWidth(), 0);
            break;
    }
    transform.rotate(Math.toRadians(rotation));
}

三、精確定位簽章位置

3.1 絕對坐標定位

直接指定簽章位置的X/Y坐標：

PdfSignatureAppearance appearance = signatureCreator.getSignatureAppearance()
    .setPageRect(new Rectangle(100, 100, 200, 50)) // x,y,width,height
    .setPageNumber(1);

3.2 相對定位策略

更靈活的定位方式示例：

// 距右下角10pt邊距的定位
float margin = 10;
Rectangle rect = new Rectangle(
    mediabox.getWidth() - 200 - margin, // x
    margin,                            // y
    200,                               // width
    50                                 // height
);

3.3 多頁簽章處理

遍歷所有頁面進行批量簽章：

for (int i = 1; i <= pdfDoc.getNumberOfPages(); i++) {
    PdfPage currentPage = pdfDoc.getPage(i);
    Rectangle pageSize = currentPage.getMediaBox();
    
    // 計算每頁特定位置
    float yPos = pageSize.getHeight() - 50 * i;
    Rectangle sigRect = new Rectangle(100, yPos, 200, 50);
    
    // 應用簽章...
}

四、可視化坐標調試方法

4.1 網格覆蓋法

生成輔助網格幫助定位：

Canvas canvas = new Canvas(pdfDoc.getPage(1), pdfDoc);
for (int x = 0; x < mediabox.getWidth(); x += 50) {
    for (int y = 0; y < mediabox.getHeight(); y += 50) {
        canvas.add(new Paragraph("("+x+","+y+")")
            .setFixedPosition(x, y, 50));
    }
}

4.2 控制臺輸出調試

打印關鍵位置信息：

System.out.println("當前頁有效區域: " + cropBox);
System.out.println("簽章將放置在: " + sigRect);

五、高級坐標處理技巧

5.1 考慮用戶單位轉換

將毫米轉換為PDF單位：

public float mmToPoints(float mm) {
    return mm * 2.83465f; // 1mm ≈ 2.83465 points
}

5.2 動態內容定位

查找文本位置作為簽章錨點：

TextMarginFinder finder = new TextMarginFinder();
PdfCanvasProcessor parser = new PdfCanvasProcessor(finder);
parser.processPageContent(pdfDoc.getPage(1));
Rectangle textArea = finder.getTextRectangle();

六、常見問題解決方案

6.1 簽章位置偏移

可能原因及解決： 1. 未考慮頁面旋轉 - 檢查getRotation() 2. 坐標系混淆 - 確認使用MediaBox還是CropBox 3. DPI差異 - 統一使用72dpi計算

6.2 跨頁簽章處理

實現騎縫章效果：

// 創建跨頁簽章矩形
Rectangle splitRect = new Rectangle(
    mediabox.getWidth() - 10, // 跨頁起始X
    100,                      // Y位置
    20,                       // 簽章寬度
    100                       // 高度
);
appearance.setPageRect(splitRect)
    .setSignatureGraphic(ImageDataFactory.create("seal.png"));

七、完整代碼示例

public class PdfSignPositioning {
    public static void main(String[] args) throws Exception {
        PdfDocument pdfDoc = new PdfDocument(
            new PdfReader("input.pdf"),
            new PdfWriter("signed.pdf"));
        
        // 獲取第一頁信息
        PdfPage page = pdfDoc.getPage(1);
        Rectangle mediabox = page.getMediaBox();
        
        // 計算簽章位置（距右下角100x50pt）
        Rectangle sigRect = new Rectangle(
            mediabox.getWidth() - 100,
            mediabox.getHeight() - 50,
            80, 30);
        
        // 創建簽章外觀
        PdfSignatureAppearance appearance = new PdfSigner(
            pdfDoc, new FileOutputStream("signed.pdf"), new StampingProperties())
            .getSignatureAppearance()
            .setPageRect(sigRect)
            .setPageNumber(1);
        
        // 添加簽章內容...
        pdfDoc.close();
    }
}

結語

掌握PDF坐標系統是實現精準電子簽章的基礎。通過iText提供的豐富API，開發者可以： 1. 獲取各種頁面區域信息 2. 處理復雜頁面旋轉情況 3. 實現絕對/相對定位策略 4. 開發可視化調試工具

建議在實際項目中結合本文介紹的技巧，先通過測試文檔驗證坐標計算邏輯，再應用到生產環境，可顯著提高簽章位置準確性。

附錄

參考資源

• iText官方文檔 - 坐標系統
• PDF 1.7規范(ISO 32000-1)
• PDF坐標可視化工具推薦

相關工具類

/**
 * PDF坐標轉換工具類
 */
public class PdfCoordinateUtils {
    
    // 毫米轉PDF單位
    public static float mmToPoint(float mm) { ... }
    
    // 處理頁面旋轉后的坐標轉換
    public static Rectangle adjustForRotation(Rectangle rect, int rotation) { ... }
    
    // 計算居中矩形
    public static Rectangle centerRect(float width, float height, PdfPage page) { ... }
}

”`