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文档的时候能用到）

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