pdx:watermarkDocx Inserts a watermark into a Word document

pdx:watermarkDocx

Inserts a watermark into a Word document.

Description

Element definition

<pdx:utilities>                                            
    <pdx:watermarkDocx pdx:src="" pdx:target="" pdx:type="image|text" pdx:section="">
        <pdx:imagePath pdx:value="" />
        <pdx:height pdx:value="" />
        <pdx:option pdx:value="" />
        <pdx:decolorate pdx:value="" />
        <pdx:gain pdx:value="" />
        <pdx:blacklevel pdx:value="" />
        <pdx:remove_previous_watermarks pdx:value="" />
        <pdx:text_orientation pdx:value="" />
        <pdx:font pdx:value="" />
        <pdx:color pdx:value="" />
        <pdx:opacity pdx:value="" />
    </pdx:watermarkDocx>
</pdx:utilities>

This element allows you to insert a watermark image or text in a Word document.

Attributes and sub-elements

src

Path to the word document.

target

Path to the resulting watermarked document.

type

Watermark type: 'text' or 'image'.

section

Section number.

options

The possible keys and values are (required options are shown with yellow background):

If type is 'image':

key	Description
image	Path to the watermark image.
height	Watermark image height in pixels (optional).
width	Watermark image width in pixels (optional).
decolorate	If true (default) decolorates the image.
gain	Optional value to customize decoloration: hexadecimal value.
blacklevel	Optional value to customize decoloration: hexadecimal value.
remove_previous_watermarks	If true (default) removes previous watermarks.

If type is 'text':

key	Description
text	The string of text used for watermarking.
text_orientation	Orientation: diagonal (default) or horizontal.
height	Watermark text height in pixels (optional).
width	Watermark text width in pixels (optional).
font	The font-family. If not set defaults to Calibri.
color	Hexadecimal value or color name (defaults to silver).
opacity	Decimal number between 0 and 1. If not set defaults to 0.5
remove_previous_watermarks	If true (default) removes previous watermarks.

Code samples

#Example 1

config.xml

<?xml version="1.0" encoding="UTF-8"?>
<pdx:document xmlns:pdx="http://www.phpdocx.com/main">
    <pdx:config>
        <pdx:output pdx:name="output" pdx:type="docx" />
    </pdx:config>
</pdx:document>

content.xml

<?xml version="1.0" encoding="UTF-8"?>
<pdx:document xmlns:pdx="http://www.phpdocx.com/main">
    <pdx:utilities>
        <pdx:watermarkDocx pdx:source="/var/www/xmldocx/samples/files/Text.docx" pdx:target="/var/www/xmldocx/samples/DocxUtilities/watermarkDocx/output_watermarkDocx.docx" pdx:type="image">
            <pdx:image pdx:value="/var/www/xmldocx/samples/files/image.png" />
            <pdx:decolorate pdx:value="false" />
        </pdx:watermarkDocx>
    </pdx:utilities>
</pdx:document>

settings.xml

<?xml version="1.0" encoding="UTF-8"?>
<pdx:document xmlns:pdx="http://www.phpdocx.com/main">
    <pdx:settings>
    </pdx:settings>
</pdx:document>

import os as os
import sys as sys
sys.path.append(os.path.abspath("wrappers/python/XmlDocx"))
import XmlDocx as XmlDocx
document = XmlDocx.XmlDocx("config.xml")
document.setDocumentProperties("settings.xml")
document.addContent("content.xml")
document.setXmlDocxPath("xmldocx path")
document.render()

The resulting Word document looks like: