Imgix APIsRendering APIBlending

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.

FamilyWhat it does
blend-gradient and its 12 companionsA color gradient over the blend layer, or a mask that fades it out
blend-fade and its 4 per-side companionsSoftens 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 bg where the output is opaque; a layer’s never does.
  • A layer’s fade never feathers a mask. With mask=corners or mask=ellipse the picture’s fade softens 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.