This Specification Task will create a text watermark on the specified pages of a target PDF file.
One watermark is added per page. The watermark text can be restyled, repositioned, and rotated.
| Property Name | Description |
|---|---|
| Title | Changes the Title (not the name) of the task. |
| PDF File | The path to the PDF file to modify. |
| Page Range | Use '*' or leave empty to select all pages. Also accepts a pipebar delimited list of page numbers, e.g. '1|2|3', or a range using a hyphen, e.g. '1-3'. |
| Watermark Text | Specifies the text value to be inserted as a watermark.
This text is inserted as a single line. |
| Watermark Font | Specifies the font to be used for the watermark.
Text decoration cannot be used when specifying a font, for example: underline. |
| Watermark Color | Specifies the color the be used for the watermark. Color names, Hex codes and RGB codes are accepted formats.
RGB codes are specified with pipe separators. If empty, black will be used as the default color. |
| Position | Specifies the relative position of the watermark on the page in the format Vertical|Horizontal. The Vertical value can be one of Top, Center, or Bottom. The Horizontal value can be one of Left, Center, or Right.
If empty, this will default to Center|Center. |
| Margins | A pipebar delimited list of margins in which the watermark must sit on the page. This property can be used to precisely adjust the position of a given watermark. Margin values are specified in the following order - Top|Right|Bottom|Left. |
| Opacity | Specifies the opacity of the watermark text as a value between 0.0 (transparent) and 1.0 (opaque). |
| Rotation Angle | The rotation angle of the watermark in degrees.
Specify positive values to achieve the desired clockwise rotation. |
When this Task is added the properties are static. To be able to build rules on a static property see How To: Change A Static Property To A Dynamic Property.
| Property Name | Example Rule | Meaning |
|---|---|---|
| PDF File | "D:\DriveWorks\MyPDF.pdf" | Will add the watermark to MyPDF.pdf. |
| Page Range | "2-4|7|9" | Will apply the watermark to pages 2,3,4,7 and 9. |
| Watermark Text | "DRAFT" | Will us the text "DRAFT" as the watermark on the specified pages. |
| Watermark Font | "font-family: arial; font-size: 20pt;" | Will use the font arial, 20pt. |
| Watermark Color | "#233f6b" | Will apply the Hex code #233f6b to the watermark text. |
| Position | "Center|Left" | Will place the watermark in the center of the page, alighted to the left-hand side. |
| Margins | "0|0|0|50" | Will adjust the left-hand margin of the available page for the watermark. This will shift the watermark to the right. |
| Opacity | 0.5 | Will make the watermark translucent. |
| Rotation Angle | 45 | Will rotate the watermark text on the page to 45 degrees clockwise. |