Insert a watermark dynamically
It exists 2 solutions:
- Insert a watermark as a Carbone tag on your template. It is possible to change the color, orientation, and opacity of the watermark. (e.g. Example 1 with Libre Office, Example 2 with MS Word)
- Insert a watermark as a PDF rendering option when requesting Carbone Render API. The watermark will be green, it is not possible to change the color, orientation, and opacity. (e.g. Example 3)
Example 1 with Libre office
The goal is to insert a watermark as a Carbone tag on the template.
On Libre Office,
From the menu, click Format > Watermark.
Insert the Carbone tag on the text field.
Then, customize the watermark by setting the font, angle, size, colors, and transparency.
During rendering, if the JSON dataset has the property watermark , such as { "watermark": "carbone.io" }, it will print the watermark with the carbone.io value. If the attribute watermark is not included on the JSON dataset, it will print nothing.
Example 2 with MS Word
The goal is to insert a watermark as a Carbone tag on the template.
On the Design tab, select Watermark.
In the Insert Watermark dialog, select Text and type a Carbone tag, such as {d.watermark}.
Then, customize the watermark by setting the font, layout, size, colors, and orientation.
During rendering, if the JSON dataset has the property watermark , such as { "watermark": "carbone.io" }, it will print the watermark with the carbone.io value. If the attribute watermark is not included on the JSON dataset, it will print nothing.
Example 3 PDF Rendering option
This example is available only for Carbone Render API or Carbone On-premise.
When PDF are generated (POST /render/:templateID), rendering options can be passed to the request to create a watermark.
The body request should include a convertTo object with a child attribute formatName set to pdf and formatOptions with options:
It will create a green watermark, such as:
More PDF rendering options are available, click to learn more.
It exists 2 solutions:
- Insert a watermark as a Carbone tag on your template. It is possible to change the color, orientation, and opacity of the watermark. (e.g. Example 1 with Libre Office, Example 2 with MS Word)
- Insert a watermark as a PDF rendering option when requesting Carbone Render API. The watermark will be green, it is not possible to change the color, orientation, and opacity. (e.g. Example 3)
Example 1 with Libre office
The goal is to insert a watermark as a Carbone tag on the template.
On Libre Office,
From the menu, click Format > Watermark.
Insert the Carbone tag on the text field.
Then, customize the watermark by setting the font, angle, size, colors, and transparency.
During rendering, if the JSON dataset has the property watermark , such as { "watermark": "carbone.io" }, it will print the watermark with the carbone.io value. If the attribute watermark is not included on the JSON dataset, it will print nothing.
Example 2 with MS Word
The goal is to insert a watermark as a Carbone tag on the template.
On the Design tab, select Watermark.
In the Insert Watermark dialog, select Text and type a Carbone tag, such as {d.watermark}.
Then, customize the watermark by setting the font, layout, size, colors, and orientation.
During rendering, if the JSON dataset has the property watermark , such as { "watermark": "carbone.io" }, it will print the watermark with the carbone.io value. If the attribute watermark is not included on the JSON dataset, it will print nothing.
Example 3 PDF Rendering option
This example is available only for Carbone Render API or Carbone On-premise.
When PDF are generated (POST /render/:templateID), rendering options can be passed to the request to create a watermark.
The body request should include a convertTo object with a child attribute formatName set to pdf and formatOptions with options:
{
convertTo : {
formatName : 'pdf',
formatOptions: {
Watermark : 'carbone.io'
}
}
}It will create a green watermark, such as:
More PDF rendering options are available, click to learn more.
Updated on: 09 / 09 / 2022