Merging Overview
Merging existing PDFs and appending existing PDFs to documents currently in memory are common tasks when using DynamicPDF Core Suite. The following pages cover each topic in more detail. Also, a brief summary of the classes used to merge is provided below.
| Topic | Class Discussed | Description |
|---|---|---|
| Merging Documents | MergeDocument | Illustrates merging two existing PDFs and appending a PDF to a document in memory. |
| Merge Options | MergeOptions | Discusses the options available to customize the results of merging. |
| Adding new Content | MergeDocument | Discusses adding new content and new pages to a document. |
| Importing Pages | ImportPage | Illustrates importing a page from an existing document as a template and then adding page elements to it. |
| Placing Imported Pages | ImportPageArea, ImportedPageData | Illustrates rotating, scaling, clipping, and placing page elements on a Page or ImportedPage. |
| Merge Optimizations | Discusses several ways to optimize document creation while merging. |
Merging PDFs and working with existing PDFs use the following classes.
All four classes are children of the Document class. For more details on each class, refer to the following documentation pages.
MergeDocument
The MergeDocument is inherited from the Document class and is used for merging PDF documents into a combined document. This class also supports appending to a PDF document and selecting pages from a PDF document.
ImportedPage
The ImportedPage class inherits from the Page class and is used to retrieve and add a single page to a document. Page elements are then added to the page and appear over the top of the original page. This behavior is useful when using a pre-existing page from a PDF document as a template.
ImportedPageArea
The ImportedPageArea inherits from the PageElement class and is used to place data from an imported PDF document onto a page. This data can then be scaled, rotated, and clipped. Or the data can be used to place multiple imported pages onto a single page.
ImportedPageData
The ImportedPageData inherits from the PageElement class and is used for placing data from an imported PDF document onto a page. This data can be scaled, rotated, and clipped. It can also set multiple imported pages onto a single page. This page element defaults to the center of the page and can be offset.