Watermark
This family of parameters allows you to overlay image or text watermarks on top of your images. You can control the alignment, width, height, cropping, alpha transparency, padding, size, position, and rotation of the watermark separately from the base image. You can also obscure and reduce the length of the watermark’s URL.
You can also stack up to 4 independent watermark layers on a single image — see Multiple Watermarks on the mark parameter page.
Shadows, Reflections, Gradients and Fades on a Watermark
A watermark takes its own copies of four picture-level families, each prefixed mark-. They use the same values, defaults and limits as the unprefixed versions, with the differences noted below.
| Family | What it does |
|---|---|
mark-drop-shadow and its 10 companions | A shadow shaped by the watermark’s own transparency, in all four shadow types |
mark-reflection and its 6 companions | Mirrors the watermark onto a glossy surface beneath it |
mark-gradient and its 12 companions | A color gradient over the watermark, or a mask that fades it out |
mark-fade and its 4 per-side companions | Softens the watermark’s edges to transparent |
Five things differ from the picture’s versions:
- The canvas never grows. A watermark’s shadow and reflection are clipped at the image’s edge instead of expanding the output.
- Lengths and fractions are the watermark’s, measured after
mark-rotand any distortion — not the picture’s. - There is no AI mode.
mark-drop-shadow-modeandmark-reflection-modedo not exist; a watermark always casts the card model. mark-gradientandmark-fadeare applied aftermark-alpha, so they turn and warp with the watermark and each tile ofmark-tile=gridgets its own.- A tiled watermark’s shadow depends on its type. Each tile of
mark-tile=gridgets its owncast,floatorinsetshadow, and a tile’s cast can fall onto its neighbours — but aflatshadow, the default, is drawn once around the whole grid.
Every one of them is indexed like the other watermark parameters: mark-drop-shadow[1]=4. The unprefixed drop-shadow, reflection, gradient and fade parameters never apply to a watermark.