PDF Stamper and Watermark Options in PDF Toolkit Command Line software
PDF Watermarks and PDF Stamps
https://veryutils.com/pdf-toolkit-command-line-tools-and-utilities
Chapter 8 Watermarks and Stamps
8.1 Add a Watermark or Logo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
8.2 Stamp Text, Dates and Times. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
8.2.1 Page Numbers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
8.2.2 Date and Time Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
8.2.3 Bates Numbers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
8.2.4 Position . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
8.2.5 Font and Size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
8.2.6 Colors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
8.2.7 Outline Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
8.2.8 Multi-line Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
8.2.9 Special Characters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
8.3 Stamping Graphics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
pdftoolkit -stamp-on source.pdf
[-scale-stamp-to-fit] [<positioning command>] [-relative-to-cropbox]
in.pdf [<range>] -o out.pdf
pdftoolkit -stamp-under source.pdf
[-scale-stamp-to-fit] [<positioning command>] [-relative-to-cropbox]
in.pdf [<range>] -o out.pdf
pdftoolkit -combine-pages over.pdf under.pdf -o out.pdf
pdftoolkit ([-add-text <text-format> | -add-rectangle <size>])
[-font <fontname>]
[-font-size <size-in-points>]
[-color <color>]
[-line-spacing <number>]
[-outline]
[-linewidth <number>]
[-underneath]
[-relative-to-cropbox]
[-prerotate]
[-bates <number>]
[-bates-at-range <number>]
[-bates-pad-to <number>]
[-opacity <number>]
[-midline]
[-topline]
in.pdf [<range>] -o out.pdf
See also positioning commands below.
pdftoolkit -remove-text in.pdf [<range>] -o out.pdf
Add a Watermark or Logo, Watermarks and Stamps
The -stamp-on and -stamp-under operations stamp the first page of a source PDF onto or under each page in the given range of the input file. For example,
pdftoolkit -stamp-on logo.pdf in.pdf odd -o out.pdf
stamps the file logo.pdf onto the odd pages of in.pdf, writing to out.pdf. A watermark should go underneath each page:
pdftoolkit -stamp-under topsecret.pdf in.pdf -o out.pdf
The position commands in Section 8.2.4 can be used to locate the stamp more precisely (they are calculated relative to the crop box of the stamp). Or, preprocess the stamp with -shift first. The -scale-stamp-to-fit option can be added to scale the stamp to fit the page before applying it. The use of positioning commands together with -scale-stamp-to-fit is not recommended.
The -combine-pages operation takes two PDF files and stamps each page of one over each page of the other. The length of the output is the same as the length of the "under" file.
For instance:
pdftoolkit -combine-pages over.pdf under.pdf -o out.pdf
Page attributes (such as the display rotation) are taken from the “under” file. For best results, remove any rotation differences in the two files using -upright first. The -relative-to-cropbox option takes the positioning command to be relative to the cro box of each page rather than the media box.
8.2 Stamp Text, Dates and Times.
The -add-text operation allows text, dates and times to be stamped over one or more pages of the input at a given position and using a given font, font size and color.
pdftoolkit -add-text "Copyright 2014 ACME Corp." in.pdf -o out.pdf
The default is black 12pt Times New Roman text in the top left of each page. The text can be placed underneath rather than over the page by adding the -underneath option. Text previously added by pdftoolkit may be removed by the -remove-text operation.
pdftoolkit -remove-text in.pdf -o out.pdf
8.2.1 Page Numbers
There are various special codes to include the page number in the text:
%Page
%roman
%Roman
Page number in arabic notation (1, 2, 3. . . )
Page number in lower-case roman notation (i, ii, iii. . . )
Page number in upper-case roman notation (I, II, III. . . )
%EndPage Last page of document in arabic notation
%Label
The page label of the page
%EndLabel The page label of the last page
%filename The full file name of the input document
For example, the format "Page %Page of %EndPage" might become ”Page 5 of 17”.
NB: In some circumstances (e.g in batch files) on Microsoft Windows, % is a special character,
and must be escaped (written as %%). Consult your local documentation for details.
8.2.2 Date and Time Formats
%a Abbreviated weekday name (Sun, Mon etc.)
%A Full weekday name (Sunday, Monday etc.)
%b Abbreviated month name (Jan, Feb etc.)
%B Full month name (January, February etc.)
%d Day of the month (01–31)
%e Day of the month (1–31)
%H Hour in 24-hour clock (00–23)
%I Hour in 12-hour clock (01–12)
%j Day of the year (001–366)
%m Month of the year (01–12)
%M Minute of the hour (00–59)
%p ”a.m” or ”p.m”
%S Second of the minute (00–61)
%T Same as %H:%M:%S
%u Weekday (1–7, 1 = Monday)
%w Weekday (0–6, 0 = Monday)
%Y Year (0000–9999)
%% The % character.
8.2.3 Bates Numbers
Unique page identifiers can be specified by putting %Bates in the format. The starting point can be set with the -bates option. For example:
pdftoolkit -add-text "Page ID: %Bates" -bates 23745 in.pdf -o out.pdf
To specify that bates numbering begins at the first page of the range, use -bates-at-range instead. This option must be specified after the range is specified. To pad the bates number up to a given number of leading zeros, use -bates-pad-to in addition to either -bates or -bates-at-range.
8.2.4 Position
The position of the text may be specified either in absolute terms:
-pos-center "200 200"
Position the center of the baseline text at (200pt, 200pt)
-pos-left "200 200"
Position the left of the baseline of the text at (200pt, 200pt)
-pos-right "200 200"
Position the right of the baseline of the text at (200pt, 200pt)
Positions relative to certain common points can be set:
-top 10
-topleft 10
-topright 10
-left 10
-bottomleft 10
-bottom 10
-bottomright 10
-right 10
-diagonal
Center of baseline 10 pts down from the top center
Left of baseline 10 pts down and in from top left
Right of baseline 10 pts down and left from top right
Left of baseline 10 pts in from center left
Left of baseline 10 pts in and up from bottom left
Center of baseline 10 pts up from bottom center
Right of baseline 10 pts up and in from bottom right
Right of baseline 10 pts in from the center right
Diagonal, bottom left to top right, centered on page
-reverse-diagonal: Diagonal, top left to bottom right, centered on page
-center: Centered on page
No attempt is made to take account of the page rotation when interpreting the position, so -prerotate must be added to the command line if the file contains pages with a non-zero viewing rotation. This is equivalent to pre-processing the document with -upright. The -relative-to-cropbox modifier can be added to the command line to make these measurements relative to the crop box instead of the media box. The default position is equivalent to -topleft 100. The -midline option may be added to specify that the positioning commands above are to be considered relative to the midline of the text, rather than its baseline. Similarly, the -topline option may be used to specify that the position is taken relative to the top of the text.
8.2.5 Font and Size
The font may be set with the -font option. The 14 Standard PDF fonts are available:
Times-Roman
Times-Bold
Times-Italic
Times-BoldItalic
Helvetica
Helvetica-Bold
Helvetica-Oblique
Helvetica-BoldOblique
Courier
Courier-Bold
Courier-Oblique
Courier-BoldOblique
Symbol
ZapfDingbats
For example, page numbers in Times Italic can be achieved by:
pdftoolkit -add-text "-%Page-" -font "Times-Italic" in.pdf -o out.pdf
See Section 14.1 for how to use other fonts.
The font size can be altered with the -font-size option, which specifies the size in points:
pdftoolkit -add-text "-%Page-" -font-size 36 in.pdf -o out.pdf
8.2.6 Colors
The -color option takes an RGB color, where red, green and blue components range between
0 and 1. The following values are predefined:
Color R, G, B
white 1, 1, 1
black 0, 0, 0
red 1, 0, 0
green 0, 1, 0
blue 0, 0, 1
pdftoolkit -add-text "Hullo" -color "red" in.pdf -o out.pdf
pdftoolkit -add-text "Hullo" -color "0.5 0.5 0.5" in.pdf -o out.pdf
Partly-transparent text may be specified using the -opacity option. Wholly opaque is 1 and wholly transparent is 0. For example:
pdftoolkit -add-text "DRAFT" -color "red" -opacity 0.3 -o out.pdf
8.2.7 Outline Text
The -outline option sets outline text. The line width (default 1pt) may be set with the -linewidth option. For example, to stamp documents as drafts:
pdftoolkit -add-text "DRAFT" -diagonal -outline in.pdf -o out.pdf
8.2.8 Multi-line Text
The code \n can be included in the text string to move to the next line. In this case, the vertical position refers to the baseline of the first line of text (if the position is at the top, top left or top right of the page) or the baseline of the last line of text (if the position is at the bottom, bottom left or bottom right).
pdftoolkit -add-text "Specification\n%Page of %EndPage" -topright 10 in.pdf -o out.pdf
The -midline option may be used to make these vertical positions relative to the midline of a line of text rather than the baseline, as usual. The -line-spacing option can be used to increase or decrease the line spacing, where a spacing of 1 is the standard.
pdftoolkit -add-text "Specification\n%Page of %EndPage" -topright 10 -line-spacing 1.5 in.pdf -o out.pdf
Justification of multiple lines is handled by the -justify-left, -justify-right and -justify-center options. The defaults are left justification for positions relative to the left hand side of the page, right justification for those relative to the right, and center justification for positions relative to the center of the page. For example:
pdftoolkit -add-text "Long line\nShort" -justify-right in.pdf -o out.pdf
8.2.9 Special Characters
If your command line allows for the inclusion of unicode characters, the input text will be considered as UTF8 by pdftoolkit. Special characters which exist in the PDF WinAnsiEncoding Latin 1 code (such as many accented characters) will be reproduced in the PDF. This does not mean,
however, that every special character can be reproduced. You must experiment. For compatibility with previous versions of pdftoolkit, special characters may be introduced manually with a backslash followed by the three-digit octal code of the character in the PDF WinAnsiEncoding Latin 1 Code. The full table is included in Appendix D of the Adobe PDF Reference Manual, which is available at
http://www.adobe.com/devnet/pdf/pdf_reference.html.
For example, a German sharp s (ß) may be introduced by \337.
8.3 Stamping Graphics
A rectangle may be placed on one or more pages by using the -add-rectangle <size> command. Most of the options discussed above for text placement apply in the same way. For example:
pdftoolkit -add-rectangle "200 300" -pos-right 30 -color red -outline in.pdf -o out.pdf
This can be used to blank out or highlight part of the document. The following positioning options work as you would expect: -topleft, -top, -topright, -right, -bottomright, -bottom, -bottomleft, -left, -center. When using the option -pos-left "x y", the point (x, y) refers to the bottom-left of the rectangle. When using the option -pos-right "x y", the point (x, y) refers to the bottom-right of the rectangle. When using the option -pos-center "x y", the point (x, y) refers to the center of the rectangle. The options -diagonal and -reverse-diagonal have no meaning.
