append

Adds blank pages at the end of the current input file, or as separator sheets in front of component files.  This command adds pages in a more flexible way than the input command, because it sets up a page (or pages) to which subsequent barcode and text commands can add barcodes or text, using values of file property variables such as ${file.$name} or ${pdf.$author}.

Syntax

To simply append one page of the same size as the last page of the input file

append

The full syntax provides options to control page size, number of pages and the scope of subsequent barcode and text commands.

append [size=]PageSize [,[pages=]PageCount] [,all]

Parameters

PageSize

Size of added page.  Optional explicit or implicit (valid size name)

The valid values are: LEGAL, LETTER, A3, A4, A5, B4, B5, B6, C3, C4, C5, C6, C65, DL, E4, E5, E6, E65, M5, M65

PageCount

Number of  pages to add (Default is 1).   Optional explicit or implicit (integer type).

all

By default the barcode and text commands that follow the append command are applied only to the first appended page.   If all is specified and the PageCount is greater than 1, then the barcode and text commands will be applied to all appended pages.

Examples

Append a blank page of the same size as the last page of the input file, and print a barcode on it with the author's name.

input "c:\MyDoc.pdf"

  append

    barcode ${pdf.$author}

Append an A4 page, and print out the list of PDFImprint variables

input "c:\MyDoc.pdf"

  append A4

    text 1,1, ${_vars}   # vars list will include PDF properties

Append three, Letter sized pages and print a barcode on each one.

input "c:\MyDoc.pdf"

  append Letter, pages=3, all

    barcode ${DocId}${page}${pages}