Debian Codegraph @

README

raw
1 CAM::PDF - PDF manipulation library
2
3
4 LICENSE
5
6 Copyright 2002-2006 Clotho Advanced Media, Inc., L<http://www.clotho.com/>
7
8 Copyright 2007-2008 Chris Dolan
9
10 This library is free software; you can redistribute it and/or modify it
11 under the same terms as Perl itself.
12
13
14 ABOUT CLOTHO
15
16 "CAM" stands for Clotho Advanced Media Inc. (www.clotho.com) which
17 originally sponsored the development of this module. Clotho no longer
18 has anything to do with this module and simply forwards inquiries to
19 me.
20
21
22 INSTALLATION
23
24 Install via one of the following:
25 perl Makefile.PL
26 make
27 make test
28 make install
29
30 or
31
32 perl Build.PL
33 perl Build
34 perl Build test
35 perl Build install
36
37
38 DESCRIPTION
39
40 This package reads and writes any document that conforms to the PDF
41 specification generously provided by Adobe at
42 http://partners.adobe.com/asn/developer/acrosdk/docs/filefmtspecs/PDFReference.pdf
43 (3rd edition, for PDF v1.4 as of May 2002)
44
45 The file format is well-supported, with the exception of the
46 "linearized" or "optimized" output format, which this module can read
47 but not write. Many specific aspects of the document model are not
48 manipulable with this package (like some font details), but if the
49 input document is correctly written, then this module will preserve
50 the model integrity.
51
52 This library grants you some power over the PDF security model. Note
53 that applications editing PDF documents via this library MUST respect
54 the security preferences of the document. Any violation of this
55 respect is contrary to Adobe's intellectual property position, as
56 stated in the reference manual at the above URL.
57
58
59 COMPARISON TO OTHER MODULES
60
61 Other Perl libraries which implement the PDF specification are
62 Text::PDF, PDF::API2, PDFLib. PDF::API2 supercedes Text::PDF. PDFlib
63 is a wrapper around the superb C library by www.pdflib.com.
64
65 All three of those libraries are optimized for programatically
66 creating new PDF documents from scratch. If that is your goal, then
67 we highly recommend that you look at those. On the contrary, CAM::PDF
68 is optimized for reading and manipulating existing PDF documents.
69
70 We use CAM::PDF in production Linux environments to customize template
71 PDF documents that were often created by non-programmers using
72 standard tools.