.github | ||
doc | ||
pdfio.xcodeproj | ||
testfiles | ||
.cppcheck | ||
.gitattributes | ||
.gitignore | ||
.lgtm.yml | ||
afl-pdf.dict | ||
CHANGES.md | ||
CODE_OF_CONDUCT.md | ||
CONTRIBUTING.md | ||
LICENSE | ||
Makefile | ||
makesrcdist | ||
NOTICE | ||
packages.config | ||
pdfio1.def | ||
pdfio_native.nuspec | ||
pdfio_native.props | ||
pdfio_native.redist.nuspec | ||
pdfio-aes.c | ||
pdfio-array.c | ||
pdfio-common.c | ||
pdfio-content.c | ||
pdfio-content.h | ||
pdfio-crypto.c | ||
pdfio-dict.c | ||
pdfio-file.c | ||
pdfio-md5.c | ||
pdfio-object.c | ||
pdfio-page.c | ||
pdfio-private.h | ||
pdfio-rc4.c | ||
pdfio-sha256.c | ||
pdfio-stream.c | ||
pdfio-string.c | ||
pdfio-token.c | ||
pdfio-value.c | ||
pdfio.h | ||
pdfio.pc.in | ||
pdfio.sln | ||
pdfio.vcxproj | ||
pdfio.vcxproj.filters | ||
pdfio.vcxproj.user | ||
README.md | ||
SECURITY.md | ||
testpdfio.c | ||
testpdfio.vcxproj | ||
testpdfio.vcxproj.filters | ||
testpdfio.vcxproj.user | ||
ttf.c | ||
ttf.h |
pdfio - PDF Read/Write Library
PDFio is a simple C library for reading and writing PDF files. The primary goals of PDFio are:
- Read and write any version of PDF file
- Provide access to pages, objects, and streams within a PDF file
- Support reading and writing of encrypted PDF files
- Extract or embed useful metadata (author, creator, page information, etc.)
- "Filter" PDF files, for example to extract a range of pages or to embed fonts that are missing from a PDF
- Provide access to objects used for each page
PDFio is not concerned with rendering or viewing a PDF file, although a PDF RIP or viewer could be written using it.
Requirements
PDFio requires the following to build the software:
- A C99 compiler such as Clang, GCC, or MS Visual C
- A POSIX-compliant
make
program - ZLIB (https://www.zlib.net) 1.0 or higher
IDE files for Xcode (macOS/iOS) and Visual Studio (Windows) are also provided.
Documentation
See the man page (pdfio.3
), frequently ask questions (FAQ.md
), and full HTML
documentation (pdfio.html
) for information on using PDFio.
Installing pdfio
PDFio comes with a portable makefile that will work on any POSIX-compliant system with ZLIB installed. To make it, run:
make all
To test it, run:
make test
To install it, run:
make install
If you want a shared library, run:
make all-shared
make install-shared
The default installation location is "/usr/local". Pass the prefix
variable
to make to install it to another location:
make install prefix=/some/other/directory
The makefile installs the pdfio header to "${prefix}/include", the library to
"${prefix}/lib", the pkg-config
file to "${prefix}/lib/pkgconfig", the man
page to "${prefix}/share/man/man3", and the documentation to
"${prefix}/share/doc/pdfio".
The makefile supports the following variables that can be specified in the make command or as environment variables:
AR
: the library archiver (default "ar")ARFLAGS
: options for the library archiver (default "cr")CC
: the C compiler (default "cc")CFLAGS
: options for the C compiler (default "")CODESIGN_IDENTITY
: the identity to use when code signing the shared library on macOS (default "Developer ID")COMMONFLAGS
: options for the C compiler and linker (typically architecture and optimization options, default is "-Os -g")CPPFLAGS
: options for the C preprocessor (default "")DESTDIR
andDSTROOT
: specifies a root directory when installing (default is "", specify only one)DSOFLAGS
: options for the C compiler when linking the shared library (default "")LDFLAGS
: options for the C compiler when linking the test programs (default "")LIBS
: library options when linking the test programs (default "-lz")RANLIB
: program that generates a table-of-contents in a library (default "ranlib")prefix
: specifies the installation directory (default "/usr/local")
Visual Studio Project
The Visual Studio solution ("pdfio.sln") is provided for Windows developers and
generates the PDFIO1 DLL. You can also use NuGet to install the pdfio_native
package.
Xcode Project
There is also an Xcode project ("pdfio.xcodeproj") you can use on macOS which generates a static library that will be installed under "/usr/local" with:
sudo xcodebuild install
You can reproduce this with the makefile using:
sudo make COMMONFLAGS="-Os -mmacosx-version-min=10.14 -arch x86_64 -arch arm64" install
Legal Stuff
PDFio is Copyright © 2021 by Michael R Sweet.
This software is licensed under the Apache License Version 2.0 with an (optional) exception to allow linking against GPL2/LGPL2 software. See the files "LICENSE" and "NOTICE" for more information.