Fit

Fits the image in a box with padding when needed

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

func=fit

The padding can be customised using the following additional operations:

Operation	Syntax	Description
gravity	gravity=X X=[north|south][east|west]	sets the position of the image in the fit box
solid background	bg_color=X | bg_colour=X X={hex color}|auto	defines a background color with a hex code, color name or automatically, based on the image palette
blurred background	bg_img_fit=1	sets blurred image background
	bg_blur=X	applies Gaussian blur to the background image
	bg_opacity=X X=0..1	specifies background image opacity
	bg_colourise=X | bg_colorize=X	defines a color to tint the background image

Gravity

northwest	north	northeast
west	center | centre (default)	east
southwest	south	southeast

Examples

Preview	Syntax
	Solid background: /docs/hotel.jpg?w=400&h=245&func=fit&bg_color=000
	Automatic solid background: /docs/frog.png?func=fit&w=400&h=220&bg_colour=auto
	Blurred background: /docs/car1.jpg?w=400&h=320&func=fit&bg_img_fit=1&bg_opacity=0.75
	Blurred background, tinted: /docs/boat.jpg?func=fit&w=400&h=330&bg_img_fit=1&bg_opacity=0.5&bg_colorize=red