PDF Multipage TIFF Adder

This adapter adds one or more images from multipage Tagged Image File Format (TIFF) files to an existing unprotected PDF document.

The images can be positioned, scaled and rotated on any PDF page. The information about the images is stored in an adapter-specific input XML document. The adapter outputs a PDF document to which the specified images have been added, as a binary data stream or as an XML document.

Properties

Operation

Determines which operation the adapter executes

Possible values: AddImages: Add images from multi-page TIFF files to the PDF document.

Parameter

Adapter

Main class of the adapter (do not change!)

Possible values: de.softproject.integration.adapter.pdf.PDFTiffImage: Main class (default)

ReadPartially

Load PDF document into memory in multiple parts (can improve the performance)

Possible values:

yes: Load in several parts one after the other into the working memory
no: Load PDF document(s) into memory in one piece (default)

toXML

Output PDF document Base64-encoded in an XML document

Possible values:

yes: Output XML document
no: Output PDF document as binary data stream (default).

Status values

`1`	The operation was executed successfully.
`-1`	The operation failed due to a technical error.

Input

This adapter expects an adapter-specific input XML structure in which information about each image is stored. This includes width and height (in cm or pt), rotation, x and y position (distances from the lower left page margin in cm or pt), the page in the multipage TIFF, the URL to the image, and the page in the PDF document where the image is to be positioned.

Each <TIFF/> element references a TIFF file and each <image/> element places an image in the PDF. If an input PDF document is a Base64 encoded data, the commented out code must be adjusted and commented in instead.

HTML/XML

<pdfTiffImage>
   <PDF url="xstore URL of the input PDF document in the repository"/>
   <!-- <PDF encoding="base64">(If input PDF is Base64 string)</PDF> -->

   <TIFF url="xstore URL of the TIFF graphic in the repository">
      <image index="Page in multipage TIFF" page="Page in PDF" 
             height="Height" width="Width" rad="Rotation (radians)" 
             degree="Rotation (degrees)" xPos="Distance from the left edge of the page" 
             yPos="Distance from the bottom edge of the page"/>
   </TIFF>
</pdfTiffImage>

Example

The following input XML document contains information about two pages of a multi-page TIF image to be inserted into a new PDF document.

HTML/XML

<pdfTiffImage>
   <PDF url="xstore://Project/Folder/Input.pdf"/>
   <!-- <PDF encoding="base64">base_64_encoded_PDF_document</PDF> -->

   <TIFF url="xstore://Project/Folder/Image.tif">
      <image index="1" page="1" height="100pt" width="300pt" rad="" 
             degree="" xPos="9cm" yPos="26cm"/>
      <image index="3" page="2" height="" width="100pt" rad="" 
             degree="" xPos="2.6cm" yPos="740pt"/>
   </TIFF>
</pdfTiffImage>