Blending
This family of parameters allows you to overlay colors, images, or text on top of your images. You can control the alignment, width, height, cropping, alpha transparency, padding, size, and position of the overlay image separately from the base image. Blending also gives you multiple blend modes that control the color interactions between the overlay and base images, similar to those in Adobe® Photoshop®.
Blend parameters can be used along with the mark and ~text parameters to overlay multiple layers on a single image. You can also stack up to 4 independent blend layers on their own — see Multiple Blends on the blend parameter page.
Gradients and Fades on a Blend Layer
A blend layer takes its own copies of the gradient and fade families, prefixed blend-. They use the same values, defaults and limits as the unprefixed gradient and fade.
| Family | What it does |
|---|---|
blend-gradient and its 12 companions | A color gradient over the blend layer, or a mask that fades it out |
blend-fade and its 4 per-side companions | Softens the blend layer’s edges to transparent |
Three things differ from the picture’s versions:
- They are applied before the layer’s warp and placement, so the gradient is laid onto the layer’s own rectangle and then transformed with it, exactly as a watermark’s are.
- A layer’s gradient mask always fades to transparent. The picture’s falls back to
bgwhere the output is opaque; a layer’s never does. - A layer’s fade never feathers a mask. With
mask=cornersormask=ellipsethe picture’sfadesoftens the shape instead of the edges; a layer’s always fades its own edges.
Both families are indexed like the other blend parameters: blend-fade[1]=0.2.