PDFlib 8 Windows COM/.NET Tutorial

The cloneboxes option instructs PDFlib+PDI to copy all page boxes of the imported page
to the generated output page, effectively cloning all page size aspects.
Alternatively, you can use the pdiusebox option to explicitly instruct PDI to use any
of the MediaBox, CropBox, BleedBox, TrimBox or ArtBox entries of a page (if present) for
determining the size of the imported page.
Imported PDF pages with layers. Acrobat 6 (PDF 1.5) introduced the layer functionality
(technically known as optional content). PDI will ignore any layer information which
may be present in a file. All layers in the imported page, including invisible layers, will
be visible in the generated output.
Importing georeferenced PDF with PDI. When importing georeferenced PDF with PDI
the geospatial information will be kept if it has been created with one of the following
methods (image-based geospatial reference):
> with PDFlib and the georeference option of load_image( )
> by importing an image with geospatial information in Acrobat.
The geospatial information will be lost after importing a page if it has been created with
one of the following methods (page-based geospatial reference):
> with PDFlib and the viewports option of begin/end_page_ext( )
> by manually geo-registering a PDF page in Acrobat.
Imported PDF with OPI information.
retained in the output unmodified.
OPI information present in the input PDF will be
Optimization across multiple imported documents. While PDFlib itself creates highly
optimized PDF output, imported PDF may contain redundant data structures which can
be optimized. In addition, importing multiple PDFs may bloat the output file size if
multiple files contain identical resources, e.g. fonts. In this situation you can use the
optimize option of begin_document( ). It will detect redundant objects in imported files,
and remove them without affecting the visual appearance or quality of the generated
output.
7.2.3 Acceptable PDF Documents
Generally, PDI will happily process all kinds of PDF documents which can be opened
with Acrobat, regardless of PDF version number or features used within the file. In order
to import pages from encrypted documents (i.e., files with permission settings or password)
the corresponding master password must be supplied.
PDI implements a repair mode for damaged PDFs so that even certain kinds of damaged
documents can be opened. However, in rare cases a PDF document or a particular
page of a document may be rejected by PDI.
If a PDF document or page can’t be imported successfully open_pdi_document( ) and
open_pdi_page( ) return an error code. If you need to know more details about the failure
you can query the reason with get_errmsg( ). Alternatively, you can set the errorpolicy option
or parameter to true, which will result in an exception if the document cannot be
opened.
The following kinds of PDF documents will be rejected by default; however, they can
be opened for querying information with pCOS (as opposed to importing pages) by setting
the infomode option to true:
190 Chapter 7: Importing Images and PDF Pages (Edition for COM, .NET, and REALbasic)