PDF 报表 Java 组件 iText5 中的单位注意事项

这里面涉及到这几个单位：

点(磅)（pt）、像素（px）、英寸（inch）、毫米（mm）

分辨率单位有：

dpi（点每英寸）：出现于打印或印刷领域。

lpi （线每英寸）：描述光学分辨率的尺度。

ppi（像素每英寸）：存在于电脑显示领域。

下面举一个例子进行说明，比如：

一个图片 test.jpg 的像素是 2468*3437

Image png = Image.getInstance(imagePath);
png.getWidth(); //获取到的是2468
png.getHeight(); //获取到的是3437

单位都是像素 px。

默认的度量系统大多以排版单位磅为基础得出其他单位的近似值，iText 中 PageSize 使用的单位就是“磅”，所以设置 PageSize 大小的时候需要将“像素”转化为“磅”。

换算过程是这样的：

1inch = 72pt = 25.4mm

这里按照 300ppi 的分辨率进行计算（为什么是300呢？这是我们公司规定的冲印分辨率），则图片的宽度由 px 换算为 pt 就是：

2468px / 300ppi * 72pt = 210pt

所以，应该这样获取 PageSize。

Rectangle pageSize = new Rectangle(png.getWidth()/300*72, png.getHeight()/300*72);

下面是根据我们公司需求写的代码，需求是将一个目录下的图片按照原尺寸合成为PDF文档，现在开始测试，将桌面上test目录下的图片合成为 测试版.pdf 文档：

package com.demo.util.iText;

import java.io.File;
import java.io.FileOutputStream;

import com.itextpdf.text.Document;
import com.itextpdf.text.Image;
import com.itextpdf.text.PageSize;
import com.itextpdf.text.Rectangle;
import com.itextpdf.text.pdf.PdfWriter;
/**
 * 
 * @author wangbo
 *
 */
public class test {
    
    public static void main(String[] args) {
        
        try {
            
             String pdfUrl = "C:\\Users\\Administrator\\Desktop\\测试版.pdf";
             String fileUrl = "C:/Users/Administrator/Desktop/test/";
             
             //建立com.itextpdf.text.Document对象的实例
             Document doc = new Document(PageSize.A4, 0, 0, 0, 0);
             //建立一个书写器(Writer)与document对象关联，通过书写器(Writer)可以将文档写入到磁盘中
             PdfWriter.getInstance(doc, new FileOutputStream(pdfUrl));
             //打开文档
             doc.open();
             
             File file = new File(fileUrl);
             if (file.isDirectory()) {
                 File[] list = file.listFiles();
                 Image png = null;
                 for (File file2 : list) {
                     png = Image.getInstance(file2.getAbsolutePath());
                     //根据图片像素设置图片的大小，单位是磅
                     png.scaleAbsolute(png.getWidth()/300*72, png.getHeight()/300*72);
                     System.out.println(png.getScaledWidth()+ "*" +png.getScaledHeight());
                     //根据图片大小设置页面的大小
                     Rectangle pageSize = new Rectangle(png.getScaledWidth(), png.getScaledHeight());
                     doc.setPageSize(pageSize);
                     //新加一页
                     doc.newPage();
                     //将图片放入文档中
                     doc.add(png);
                 }
             }
             
             //关闭文档
             doc.close();
             
             //进行pdf文件生产
             File pdfFile = new File(pdfUrl);
             if (pdfFile.exists()) {
                 pdfFile.createNewFile();
             }
            
        } catch (Exception e) {
            e.printStackTrace();
        }
        
    }
    
}

补充一下：我这用的是iText5，没研究iText7，据说这两相差的还比较大，需要的jar包有：（其中的clover包生成World文档的时候能用到）

 再补充一篇网上找的帮助文档：https://files.cnblogs.com/files/wbyp/iText中文教程%28含代码%29.pdf