Components All New MacOS Windows Linux iOS
Examples Mac & Win Server Client Guides Statistic FMM Blog Deprecated Old

PDFKit.Watermark

Adds a watermark to a page.

Component Version macOS Windows Linux Server iOS SDK
PDFKit 2.7 ✅ Yes ❌ No ❌ No ✅ Yes, on macOS ✅ Yes
MBS( "PDFKit.Watermark"; PDF; PageNumber; Image; Transparency; X; Y { ; W; H; Background; DeltaX; DeltaY } )   More

Parameters

Parameter Description Example Flags
PDF A PDF reference from PDFKit.Open. $pdf
PageNumber The page number of the page to modify. 0
Image The image to be used for watermark. Should be a PNG with mask for best results. Pass a container value. $image
Transparency The transparency level. From 0.0 (opaque) to 1.0 (full transparency). 0.5
X X coordinate. If zero, the plugin will center the image. If negative, this value is the distance from right side. 0
Y Y coordinate. As with all PDF coordinates, the 0 coordinate is on the bottom of the page. If zero, the plugin will center the image. If negative, this value is the distance from top side. 0
W Desired width. If value is zero or not provided, the plugin will use the image width. 0 Optional
H Desired height. If value is zero or not provided, the plugin will use the image height. 0 Optional
Background Whether to put image in foreground or background. Default is foreground. Can be 1 for background or 0 for foreground. Does not work if existing page clears background with background color! 0 Optional
DeltaX Additional positioning offset to be added after the calculations for above are done. 0 Optional
DeltaY Additional positioning offset to be added after the calculations for above are done. 0 Optional

Result

Returns OK or error message.

Description

Adds a watermark to a page.
This modifies an in memory PDF Document which you can create by opening one using PDFKit.Open, PDFKit.OpenContainer, PDFKit.OpenPath or PDFKit.OpenURL.
You can watermark several pages by calling this function in a loop.
Don't forget to use PDFKit.Release to later release memory.
You can do similar with DynaPDF with insert image command (DynaPDF.InsertImage) and alpha set (DynaPDF.SetAlpha).

Your changes are only done in memory, so please remember to write modified pdf back to disk, e.g. by using PDFKit.WriteToPath. Or use PDFKit.GetPDFDocument to get a PDF for storing in a container.

Examples

Watermark with an image over full page:

MBS("PDFKit.Watermark"; $pdf; 0; Watermark PDF Page::WatermarkImage; 0; 0; 0; 0; 0)

See also

Release notes

Example Databases

Blog Entries

This function checks for a license.

Created 18th August 2014, last changed 28th November 2019


PDFKit.SetPrintSetting - PDFKit.WriteToPath