Adding and removing watermarks and backgrounds

Like headers and footers, watermarks and backgrounds specify text or graphics to add to the existing page content. Watermarks are placed on top of the existing page content and are specified by means of the Watermark element. Backgrounds are placed behind the existing page content and are specified by means of the Background element.

Watermarks and backgrounds are similar to headers and footers in these ways:

•

In LiveCycle 7, you could add at most one watermark and one background to a destination page, and when you added a watermark or background, any previous one was removed. InLiveCycle ES 8.0 and later you can retain pre-existing watermarks and backgrounds by setting the replaceExisting attribute to false. For more information, see the Document Description XML Reference.

Note: You can specify a different watermark or background for even and odd pages within a given scope (see Odd and even pages).

•	A Watermark or Background element can specify its content either as direct child elements or by means of the styleReference attribute that refers to a StyleProfile element containing a watermark or background description.

•	The content of a watermark or background can be either a StyledText element or a single PDF source element. When using a PDF source, the first page in the pages specified for the source is used as the watermark or background.

•	If Watermark or Background are not explicitly specified for the current scope but are specified for a parent scope, the parent Watermark or Background apply to the current scope.

•	You can use the NoWatermarks and NoBackgrounds elements to ensure that a group of pages contains no watermarks or backgrounds.

Watermarks and backgrounds differ from headers and footers in that they are not restricted to specific areas of the page. You can specify the placement of a watermark or background using several attributes (see the Document Description XML Reference for details. You can also specify rotation and transparency.

Watermark and Background elements can be children of the following elements, which correspond to the pages on which they can appear:

•	PDF or PDFGroup elements (source pages)

•	TableOfContents or TableOfContentsPagePattern elements (table of contents pages)

•	BlankPage elements (blank pages)

When you specify a watermark or background for a page (even if it contains no text or graphics), any watermark or background that was previously added to the page, through Acrobat or the Assembler service, is removed.

You can specify a different Watermark or Background for even and odd pages within a given scope. (See Odd and even pages.)

Note: The Assembler service supports only unfiltered data, ASCIIHex filters, and ASCII85 filters for inline images in watermarks and backgrounds. All other filters in inline images are unsupported in these operations.

Watermarks and backgrounds (as with all other page content) follow scoping rules. (See Scope of page elements.) In the following example, the Watermark element is a child of the PDF result element, and it specifies a watermark that applies to all other children of the PDF result element that do not specify a watermark. Therefore the watermark applies to all the pages in doc1 and doc2.

Example: Adding a watermark

<PDF result="myPDF">

	<Watermark rotation="45">

		<StyledText><p><b>Draft</b></p></StyledText>

	</Watermark>

	<PDF source="doc1"/>

	<PDF source="doc2"/>

</PDF>

In the following example, the watermark specified for the PDF result still applies to the pages from doc1. However, the pages from doc2 will have a different watermark, supplied by a PDF page (the second page of myWatermark). The pages of doc 3 have no watermark because of the presence of the NoWatermarks element.

Example: Adding a watermark from a PDF page

<PDF result="myPDF">

	<Watermark rotation="45">

		<StyledText><p><b>Draft</b></p></StyledText>

	</Watermark>

	<PDF source="doc1"/>

	<PDF source="doc2">

		<Watermark>

			<PDF source="myWatermark" pages="2"/>

		</Watermark>

	<PDF/>

	<PDF source="doc3">

		<NoWatermarks/>

	</PDF>

</PDF>

Backgrounds follow the same rules as watermarks, including the ability to use the NoBackgrounds element.

Send me an e-mail when comments are added to this page | Comment Report

Current page: http://livedocs.adobe.com/livecycle/es/sdkHelp/programmer/sdkHelp/assemblePDFPage_content.103.5.html

Add Comment