Defining an Image Watermark

<< Click to Display Table of Contents >>

Navigation:  GDI Print Directives > Watermarks >

Defining an Image Watermark

//PDFX,Watermarks.DefineImage, Wname, ImgSpec, TransColor, Width, Height, Align, Xoffset, Yoffset, Angle, Opacity, Flags, PlaceType, PageRange

Parameters

The parameters not listed below have the same meaning as for the Watermarks.DefineText directive, except Flags, which has two additional options:

Symbol

Values

Description

Wname

string

Name to assign to the watermark definition. You'll need to refer to this name in the Watermarks.Watermarks directive to invoke it.

ImgSpec

string

Specifies the file spec of the image to use for the watermark, in either AMOS-style or native format. Supported formats: BMP, PNG, JNG, JPEG, JPEG 2000, TIFF, JBIG, JBIG2, GIF, PCX, DCX, EMF, WMF.

TransColor

Integer (RGB)

Specifies the RGB value of the color within the image to treat as transparent. Use the standard A-ShellBASIC hex notation for RGB values (&hBBGGRR), e.g. &hFFFFFF for white.

Width, Height

integer

Specify the display width and height of the watermark, in tenths of millimeters. The image will be scaled to this size. Applicable only if the &h0100 bit in the Flags parameter is not set.

Flags

Integer (sum)

Indicates options relating to the placement and visibility of the watermark, and may combine zero or more of the following. Flags has the values as for the Watermarks.DefineText directive, with these two additional options:

 

&h0100

Scale the watermark to fit the page, ignoring the Width and Height parameters

 

&h0200

Don't retain aspect ratio when scaling.

 

Example

Definition of the image watermark shown in the example above.  It is named “WM2”, consists of the image file logo.png, the transparency color is pure white, i.e. RGB(255,255,255), the display width and height are both set to 180.0 millimeters, alignment set to both vertical and horizontal center (17), zero offsets, zero rotation angle, 15% opacity, flags 30 (background, visible in viewer, when exported and when printed), all pages.

//;define an image watermark

//PDFX,Watermarks.DefineImage,WM2,img:logo.png,&hffffff,1800,1800,17,0,0,0,15,30,0

//;enable watermarks

//PDFX,Watermarks.Enabled,True

//;And specify this watermark

//PDFX,Watermarks.Watermarks,WM2

 

Compatibility

New in PDFXv5.