Fit

Resizes the image to fit into a specified width and height box, adds padding (image or solid colour) to keep proportions, and delivers the resulting image via CDN.

func=fit

The padding can be customised using the following additional operations:

functionnamedescription
gravitygravity=X
X = [north | south][east | west]
sets the position of the image in the fit box
solid backgroundbg_colour=X | bg_color=Xdefines a background colour either with a hex code or colour name
blurred backgroundbg_img_fit=1sets blurred image background
bg_blur=Xapplies Gaussian blur to the background image
bg_opacity=X
X = 0..1
specifies background image opacity
bg_colourise=X | bg_colorize=Xdefines a colour to tint the background image

Solid colour padding

/v7/sample.li/car1.jpg?w=400&h=320&
func=fit&bg_color=black

For details, please see the solid background section.

Gravity

The gravity=X operation sets the position of the image when padding is added. Possible values are:

northwestnorthnortheast
westcentre | centereast
southwestsouthsoutheast

If not explicitly set, the default gravity is centre.

For example, by setting gravity to south, the image is positioned at the bottom and the padding is added at the top.