PDF-API2 编程指南

《PDF-API2 编程指南》由会员上传分享，免费在线阅读，更多相关内容在教育资源-天天文库。

1、PDF::API2编程指南PDF::API2编程指南版本0.10-2004-08-20-Originalversionpostedathttp://www.printaform.com.au/clients/pdfapi2/0.20-2007-02-14-完成代码修正、文档更新、页面样式调整。下载链接修正。指南编程样例PDF是一种强有力的文档发布媒体，掌握对它的处理将为你带来很大的优势。不过要提醒的是文档中有不少相关的术语，所以你可以直接使用样例代码，不必强求全面深入的理解。这篇文档是用来教你使用PDF::API2这个模块的，它可以说是Perl程序员可以使用的最深

2、入的PDF工具模块了。但是本文不会深入介绍PDF本身，如果你感兴趣的话，Adobe的网站上有足够了解细节的规范可供下载。为了使用PDF::API2，有几个必要的步骤。这篇文章会涉及那些最基础的创建PDF的步骤。实际应用中应该还有很多其他的功能和选项可以考虑的。这篇文章最初是为了PDF::API2的0.03.77版本而编写的。如果你使用的是更早的版本，我建议你进行升级。当然不升级也许没问题，但是我不能保证。自从0.04版发布以来，我还没有发现有什么改动会与这个文档产生冲突。我是谁？我是一个Perl爱好者，就像你一样。只不过我在出版业工作了十二年以上，在印刷之前所有工

3、序的技术问题上面都有些经验。我解决过的问题包括数据和软件相关的，也有颜色管理方面的，还有照排或系统相关的。在编写本文档的时候，我正在为一个项目工作。那个项目中需要使用PDF::API2来实现在线文具订购系统的精确预览功能。之后我还用PDF::API2为一个垃圾邮件过滤公司实现了较为复杂的报表系统。如何使用PDFPDF的优势是可以在一个文件中嵌入各种信息，比如颜色、文字，以及字体和图片。所有这些内容都可以用单个文件发布出去，然后既可以在屏幕上显示，也可以进行高精度的打印输出。PDF的内置颜色管理功能对于那些高端输出系统来说是非常受欢迎的。因为PDF集成了这么许多功能

4、，对于它的编程也会比较复杂，不过你还是可以逐渐上手。这个指南主要介绍了那些比较复杂的边框处理功能。也许有一天我会有时间进一步介绍其他的细节。不过对于PDF来说，你其实不必了解所有的细节也能使用它或进行相关的编程。你可以在LGPL协议的约束下使用text_block这个子程序。一些重要的PDF概念媒体框、出血框、媒体框和作品框当你观察一篇打印的文档时，可能会注意到某个图片或某个色块恰好覆盖到了纸的边界。让我告诉你一个秘密吧：其实它会超出边界！每个打印机生厂商可能会有不同程度的越界宽度，但是肯定都支持越界。这种界限被称为出血线。另外一件要注意的事就是我们并非在真正的纸

5、张大小范围中打印。如果是那样的话，出血线以外的东西也会被打印在纸上，这可不是什么好事。所以在A4纸（或者信纸）上打印的时候，其实我们会稍稍超出A4的范围一些，这样出血线就能和纸张边缘尽量靠近。我们把纸张称为媒体，因为你可能还会在塑料、幻灯片、T恤等物品上打印。在打印之后，我们可以把打印件切成你需要的大小。这个界限就被称为裁切范围。理论上说，任何需要最终展示的信息都不应该超过这个范围，除非打印机有什么限制。现在还剩下的就是作品框了。这个范围顾名思义就是用来容纳真正重要的“艺术品”的地方。一般来说这个范围离裁切框的距离和出血框离裁切框的距离相等。这么规定是因为尽管现在

6、的打印机都很精确，但是还不能算完美。如果你的文档中有些重要的内容超越了这个界限，那么很有可能在实际的输出中会看不到它。核心字体、postscript字体、truetype字体和构造字体如同之前介绍的，PDF能把各种信息集成在一个文件中，也包括其中使用的字体。字体的来源比较多，但是对于PDF::API2来说，真正支持的字体其实只有核心字体、postscript字体和truetype字体。我们不会在这个文档中介绍所有的字体，而只会使用核心字体，因为它完全不依赖于外部文件。度量系统以及座标原点PDF默认情况下会使用”点“作为长度单位，不过这里的例子程序会显示如何使用那些

7、大家更加习惯的单位（下面会看到，我用的是毫米）。座标轴的原点被定在左下角，这类似于笛卡尔座标。一般来说我们习惯于把左上角定义为(0,0)，座标轴指向右下角。但是在处理PDF的时候，你需要习惯这种左下角为原点的座标系统。当然，要是能知道纸张的大小，那么应该很容易写一个函数进行两种座标的转换，不过这里不会介绍它的实现。软件安装安装PDF::API2的步骤在这个文档中不会介绍，不过类似于其他所有的CPAN模块的安装那样，在Linux或其他Unix衍生系统上你可以用下面的命令：sudoperl-MCPAN-e"installPDF::API2"如果你遇到了安装问题，那么可

8、以问问系统