Watermarking

Watermarks are applied at the alias level.

Watermarking Examples

On the alias settings, you turn it on by specifying an overlay image, then setting options like:

• Scale Percentage - Adjust the size of the overlay image.
• Tiled - Yes or No.
• Position - Only applies when the watermark is not Tiled.

Tiled

A tiled watermark will take a png and paint it on top of your image as many times as it can, one after the other, going across and going down.

&w=320&h=180&bgc=_abd

&w=240&h=120&bgc=_abd

Positioned

A positioned watermark will place the png at the center of your images.

&w=320&h=180&bgc=_abd

&w=240&h=120&bgc=_abd

The options for placing the watermark are

northwest     north     northeast
west          center         east
southwest     south     southeast

Combining with Access

Combining watermarking and alias-level access, we can build the following scenario:

Given a group of images,

• allow anyone to request the images with a watermark applied
• allow a select list of domains to request the same images without the watermark

For this you’ll need two aliases.

With this configuration, let’s assume there is an image called image1.png

This image can be accessed as

/v2/token/watermarked/image1.png

and it will always have the watermark. This image is available to anyone.

This image can also be accessed as

/v2/token/protected/image1.png

but it will only work for the selected referers listed in this alias. Other requesters will receive a 403 forbidden error.