PDF源文件浅析

 

应该项目需要，初步研究了一下 PDF 的格式，打算和大家分享一下，如果有想做 PDF 或 PDF 阅读器开发的同学们，可以看看。

 

 

PDF 格式规范，语法简洁。但初次查看 PDF 却容易给人错觉 ——PDF 的二进制流太多了，原本清晰的数据格式被杂乱无章的二进制流给淹没了。

 

例如：

 

stream
5di?倯? 貓?匚{o绝幾Te:馎HG
嵶?W}?妮雥??隱q?屸鷭鴊狳!赭€?鼜 ??烖K柽z煜?w? ??鴚¬D¬h?斜?醱釓?x?i佲匃???灗  Iu叁剪?
…………………………

 

像这样一大堆乱码的东西很多，所以，心理上无法耐心的继续看下去。

 

 

实际上 PDF 就是由四部分组成：

 

 

 

 

数据流的读写操作一般是从文件末尾开始的：

 

 

 

 

PDF 所有的数据类型都是 obj ，强调的也是一切皆对象。我简要的把 PDF 常见的几种数据类型给大家说说：

 

注意“ % ”表示注释

1.       Boolean Objects ：只有 true 和 false

2.       Numeric Objects ：

l         整型： 123

l         浮点型 -43.54 ， 6.02E23

3.  String Objects ：

l         文字型，用圆括号括起来，如： (Hello World)

l         十六进制型，用尖括号括起来，如： <901FA3> 分别为 90 ， 1F ， A3

4.  Name Objects ：除 null 以外的任意 8 位字符组成的字符串，出现在 PDF 中，用“ / ”作前导符号，如： /Name1 。其实这与编程中的常量很类似。

5.  Array Objects ： PDF 中的数组用方括号“ [] ”括起来，里面的数据可以完全不相同，如： [549 3.14 false (Ralph) /SomeName] 该数组里面分别装有 5 种不同的类型。

 

6.        Dictionary Objects ：其实就类似于 Java 的 Map 对象——即以 key ， value 的形式成对出现。用的时候要用“ <<…>> ”把 key ， value 括起来。例如： <</Name (leo) >> 表示 key 为“ name ”的 Name Objects ，而 value 为“ leo ”字符串。 <<>> 内部也可以嵌套使用，在 PDF 源文件中应用的非常广泛。

7.        Stream Objects ：顾名思义，肯定有流有关。这就是 PDF 中专门用于存放二进行流的对象。 PDF 的实现者对 String Objects 通常会做限制，但是 Stream Objects 却没有这样的限制。因此 stream object 用在图片，页面描述信息上是非常的适合的。

看看使用示例：

 

 

7 0 obj 		 			%某一个Image类型的对象
<<
/Type /XObject
/Subtype /Image
/Name /Im7
/Width 189
/Height 189
/BitsPerComponent 8
/ColorSpace [/Indexed /DeviceRGB 255 …>]
/Mask [255 255]
/Length 3832
/Filter /FlateDecode
>>						%紧接着这个对象定义后的Dictionary Objects对象后面
stream 					%定义它的Stream Objects
%这里放二进制流
endstream

 

 

 

8.        Null Object ：区别与其它任何对象，用关键字 null 标注的对象就是 null object 。

9.        Indirect Objects ：当然就是类似 Java 中的“引用”概念啦，举个例子就说明一切了。

 

 

7 0 obj  				%有一个索引号为7 0的对象
<< /Length 8 0 R >>  	% 在它的Length属性引用了一个索引号为8 0的对象
　　　　　　　　　　　　　%在这里“8 0 R”表示对8 0的对象引用(Reference)
stream
………….
endstream
endobj


8 0 obj				%被上面7 0对象所引用的那个索引号为8 0的对象
77 					%7 0对象的二进制流的长度
endobj

 

 

注意：   obj …… endobj PDF 文档组成的最小 组成部分。表示一个完整对象的定义

 

 

 

 

够了，说了这么多，让我们实战吧。现在我们来看一个完整的示例，该示例可以在附件中下载。看的时候，可以按照下面的步骤一步一步来分析 PDF 源文件：

 

 

 

%PDF-1.3
%
2 0 obj                                 %2 0 obj，里面是一些PDF的基本信息。比如
<<				
/CreationDate (D:20081029093606+08'00')　　%创建时间
/ModDate (D:20081029093606+08'00')		　 %最后修改时间		
/Producer (leo 4.30 \(0615\))　　　　　　　　%创建人
/Creator (easyPDF SDK 4.3)　　　　　　　　%制作人
>>　　　　　　　　　　　　　　　　　　 %你还可以自由的编写任何信息
endobj

1 0 obj
<<
/Count 0
>>
endobj

3 0 obj									%这是PDF的根结点(不是起始位置)
<<
/Type /Catalog
/Pages 4 0 R								%这是所有页面的集合，我们主要关心这个
/Outlines 1 0 R
>>
endobj

7 0 obj
<<
/Type /XObject
/Subtype /Image
/Name /Im7
/Width 189
/Height 189
/BitsPerComponent 8
/ColorSpace [/Indexed /DeviceRGB 255 <%这里放每个像素点的值>]
/Mask [255 255]
/Length 3832
/Filter /FlateDecode
>>
stream
%这里放的全是图片的二进制流……..
endstream
endobj

8 0 obj
<<
/Length 51
/Filter /FlateDecode
>>
stream
%这里放的全是图片的二进制流……..
endstream
endobj

6 0 obj									%重点分析一下这个
<<
/Type /Page
/Parent 4 0 R
/MediaBox [ 0 0 595.276 841.89 ]
/Resources <<
/XObject <<
/Im7 7 0 R
>>
/ProcSet [/PDF /Text /ImageB /ImageC] >>
/Contents 8 0 R
>>
endobj

4 0 obj
<<
/Type /Pages
/Kids [
6 0 R							%继续查找6 0 obj来看看具体的页面情况
]
/Count 1
>>
endobj

xref						%索引，f表示该地址未被使用，n表示已经被占用。
0 9								%索引的顺序与对象在文中出现的序号是一致的，比如
0000000000 65535 f               %默认占位符，不使用。
0000000177 00000 n 　　　　　　　%表示0 1 obj的偏移地址
0000000015 00000 n 　　　　　　　%表示0 2 obj的偏移地地 下面的以些类推
0000000208 00000 n 
0000006159 00000 n 
0000000000 00000 n 　　　　　　　%表示0 5 obj的偏移为0，可能被删除操作给干掉了。
0000005981 00000 n 
0000000274 00000 n 
0000005858 00000 n 
trailer
<<
/Size 9
/Root 3 0 R						%这个属性信息最重要，我们可以直接找到根结点
/Info 2 0 R
/ID[<112cbcc8320742d1cbe148d4ec0d7dba><112cbcc8320742d1cbe148d4ec0d7dba>]
>>
startxref							%PDF文件解析的起点
6219
%%EOF

 

 

 

第一步： 首先是先看文件末尾，找到它的“ xref ”和“ trailer ”部分。 Xref 表示对象索引，其实就是对象在文件中的偏移地址（ PDF 源文件中是以 10 进制表示的，你转换成 16 进制后，用 UE 或者其它工具查看即可） 。

 

Trailer 虽然从字面上看是“尾部”的意思，但是解析却从它开始。“ startxref ”表示文件的入口地址，像 java 的 main() 方法。后面紧跟着一个 10 进制的数字，指向的是索引“ xref ”的位置。

 

Trailer 里面的值分别表示：

 

1.       Size 9 ：表示 9 个索引值

2.       Root 3 0 R ：根结点是 3 0 obj 的引用

3.       Info 2 0 R ：相关信息是 2 0 obj 的引用

4.       ID ：类似于 Java 的 Serializable 机制，给本 PDF 文件生成一个独一无二的标识

 

 

第二步： 按照 Root 3 0 R ，我们向上查找，找到了我们要找的 Root 对象，里面的信息从字面上很容易理解：

 

1.       /Type /Catalog ：表示该对象的类型是目录

2.       /Pages 4 0 R ：表示所有的 PDF 页面在一个叫 4 0 R 的对象上

3.       /Outlines 1 0 R ： PDF 文件的大纲，也就是左侧展示的东西。

 

继续查找 4 0 obj ，果然与预期所想的一样，的确是所有页面的集合，并且还有一个附加属性 Count 统计页面对象的个数：

 

/Type /Pages ：表示该对象的类型是所有页面的集合

/Kids […] ：这是一个数组，里面装的是每个页面的具体引用。因为这个 PDF 就一页，所有只有一个“ 6 0 R ”。下一步，就从这里入手。

/Count 1 ：页的总数大小，因为这个 PDF 就一页，所以值为 1 。编程时可能会用到。

 

 

第三步： 来重点分析一下页对象

 

 

6 0 obj              	%索引编号为6的对象，0表示该对象的修改次数
<<                 	% << 表示是这一个map，里面的所有数据都以key，value形式出现
/Type /Page  			%其类型为Page，表示PDF的每一页
/Parent 4 0 R			%其父结点为4 0对象（R表示引用，对象之间是可以双向引用的）
/MediaBox [ 0 0 595.276 841.89 ]	%当前页画布为MediaBox样式，后面的表示左上角与右下角坐标，这样就形成了一个矩形。
/Resources <<			% Resources 又为一个map的嵌套
/XObject <<			% XObject 也是一个map的嵌套
/Im7 7 0 R		% 在Xobject中定义了一个叫Im7的名称，引用了叫Im7的7 0对象（在我的PDF中，这是一个图片对象）
>>					
/ProcSet [/PDF /Text /ImageB /ImageC] >> % 打印时的参数设置
/Contents 8 0 R        % 这里是实际页面上的内容信息，引用的是8 0对象
>>
endobj				% 对象定义结束

 

 

 

对于我们来说，以下是项目开发的重点。因为要实现 PDF 文件盖章的添加或删除功能，必须进行流操作，并且图片在 PDF 文件的位置也要写入。

 

l         /XObject<<>> ： 里面持有图片等二进制的引用。通过上述的方法，当你再查看 7 0 obj 时，就会看到大量的二进制文件了。

l         /Contents ： 是文件的内容信息。比如说，页面上的文本，图片的坐标位置等。

 

 

 

通过这个完整的流程，你应该明白 PDF 的格式其实就是一个层次分明的树形结构。不过，想完全了解 PDF 的格式，进行相关的操作。你还得参看 PDF 规范文档。