PDF Labs

[ include=< page option file > | - ]...

[ output=< output filename > | - ]

[ alpha=< transparency factor > | - ]

[ verbose ]

< page range handle >< option key >=< option value >

described below, and

< page option file > is the filename of a text file containing < page options >, one < page option > per line, and

< output filename > is the filename of the PDF to create. If omitted, then stamptk outputs to stdout.

This is the text you want displayed on the page. It is restricted to the CP-1252 character set. You can set only one of these per page range, but you can add multiple text strings to a page by using multiple page ranges. It is encoded in CP-1252, optionally using escaped octal (\000) or hexadecimal (\xHH) for non-ASCII characters. Backslashes must be escaped using a backslash (\).

This is the text you want displayed on the page. It is restricted to the CP-1252 character set. You can set only one of these per page range, but you can add multiple text strings to a page by using multiple page ranges. It is encoded in UTF-8.

This option sets the text’s position on the page. X or Y can either be an absolute coordinate on the page or one of the rela- tive arguments. Absolute coordinates are in points (72 points per inch), and the page origin is in the lower-left page corner. The relative arguments are relative to the page. X relative arguments are: center, left or right, and Y relative arguments are: center, top or bottom. Default: center,center

This sets the text’s origin to use when positioning the text on the page with pos. X can be: center, left or right, and Y can be: center, top or bottom. These describe the location of the text’s origin using the text’s borders. Default: center,center

This sets the text’s size in points (72 points/inch). Default: 14

This sets the text’s color. You have two formatting options: decimal or hex. When using decimal formatting, red, green and blue are decimal values between 0 and 255. When using hex formatting, RR, GG and BB are hexadecimal values between 00 and FF. Default: #000000 (black)

This is the font used to display the text. It can be one of:

If you add a page stream (described below) that uses one of PDF’s standard fonts, then set this font option to match for the relevant page(s). That will ensure that the required font resources are packed into the PDF page. If no text or stream is given for any page range, then no font resources are added to the PDF. Default: sans

This sets the text’s angle. It uses compass points to divide the circle into 45-degree pieces. For example the N angle gives you right-reading text and the E angle rotates the text 90 degrees clockwise so it reads from top to bottom. Text is rotated on its origin, described above. Default: N

This allows you to add your own PDF page description code to the pages in the range. The given keywords delimit the PDF code that will be added to the PDF page verbatim. There is a newline after the first keyword and another newline before the last keyword. This can be used in combination with the text, textUTF8 and related options. When using only the stream option, the only other options to consider are the range, embed, media and font options — the other options relate only to adding text to the pages. You can apply multiple streams to a single page by using multiple page ranges.

This takes an arbitrary string and invisibly embeds it into each page’s PDF dictionary using the dictionary key stamptkData. This is useful if you have data you want to pass to a PDF parser downstream. Parentheses and backslashes must be escaped with a backslash. Only one can be set per page. If more than one range sets this option, only the final setting will be used — values are not appended the way page text and page streams are. Maximum length: 64k bytes.

This sets the page dimensions. For standard page name use one of: letter, tabloid, ledger, legal, statement, executive, folio, A0, A1, A2, A3, A4, A5, B4 or B5, and you can append Landscape to change its orientation. Or, you can give the page width and page height in points (there are 72 points per inch). Default: letter

is used in conjunction with relative pos values (top, bottom, left, right) to tell stamptk how much space to keep between your text origin and the edge of the page. It is an integer value and its units are points (there are 72 points per inch). Default: 24

where the page numbers give one or more pages to be used for this page range. Page numbers are 1-based, so the first page is numbered 1, not zero. On page ranges, you can append Even or Odd to effect just those pages. Default: 1