Operations

Basic image resizing operations

Resizing operations enable the dynamic generation of image transformations to meet various web delivery use cases. Operations focus on the image size while allow to modify the image itself.

Available operations

Operation	Syntax	Description
Width and height	width=X	sets the image width to X pixels
Width and height	height=X	sets the image height to X pixels
Prevent enlargement	org_if_sml=1	prevents resizing if the target size is larger than the origin image
Crop	func=crop	sets crop resize function
Gravity crop	gravity=X	defines the part of the image to be retained when cropping X = [north | south][east | west] | auto | X,Y
Positionable crop	tl_px=X,Y	sets coordinates of the top left corner of the cropping rectangle
Positionable crop	br_px=X,Y	sets coordinates of the bottom right corner of the cropping rectangle
Face crop	func=face	crops the image automatically focusing on the most prominent face
Fit	func=fit	sets fit resize function
Cropfit	func=cropfit	sets crop or fit resize function depending on the origin and the desired dimensions
Bound	func=bound	sets bound resize function
Boundmin	func=boundmin	bounds the image to the larger dimension
Cover	func=cover	sets cover resize function (distorts image proportions)
Flip	flip=[h][v]	mirrors the image horizontally and/or vertically
Rotate	r=X	rotates the image to X degrees (counterclockwise)
Trim	trim=X	trims any solid-color border (if present); X is the aggressiveness of the operation
Rounded corners	radius=X	applies rounded corners and optionally fills the empty background with a color

Do not hesitate to contact us if you need any additional operations not listed above

Resize functions

When you specify both width and height, original image proportions can be either ignored or maintained. Also, you may choose to add padding to the image to fill the blank space.

Filerobot supports the following resize function (operation func).

Crop

Keeps image proportions cutting the image to fit the defined width and height; see

This resizing function removes parts of the image and is the default behaviour when both width and height are defined. Read further for other resizing functions.

Preview	Syntax
	/docs/hotel.jpg?w=400&h=200&func=crop

Fit

Resizes the image keeping proportions and adding padding to satisfy the desired dimensions; see

Preview	Syntax
	/docs/hotel.jpg?w=400&h=200&func=fit&bg_color=000

Cropfit

Performs either Cropor Fit based on image dimensions and transformation parameters; see

This resizing function may remove parts of the image

Preview	Syntax
	650x500 origin image, cropped: /docs/classroom.jpg?func=cropfit&w=500&h=350&bg_colour=auto
	Same parameters, 400x250 origin image: /docs/ny_doc.jpg?func=cropfit&w=500&h=350&bg_colour=auto

Bound

Fits image in a box of defined size without adding padding; see

Preview	Syntax
	/docs/hotel.jpg?w=400&h=200&func=bound

The boundmin operation is a special case of bound where the smaller dimension is respected instead of the larger one, see

Cover

Resizes the image to the given width and height ignoring original image proportions, thus distorting the image; see

Preview	Syntax
	/docs/hotel.jpg?w=400&h=250&func=cover

For troubleshooting purposes, use the ci_info=1 operation to view details about resizing and compression, for example: /docs/hotel.jpg?w=400&ci_info=1