Cloudimage - Documentation

Centred crop

Crops the image to specified dimensions (width and height), keeps proportions and delivers the resulting image via CDN.

func=crop

Original image, only resized

/sample.li/birds.jpg?w=400

If you set both width and height options, you can omit the func=crop option since it is the default operation for this case.

Gravity

Specifies which part of the image you wish to keep while cropping. If you omit the gravity option, centred cropping is performed.

gravity=X

Available gravity values

northwestnorthnortheast
westcentre | center (default)east
southwestsouthsoutheast
auto (more information)X,Y - focal point (more information)face (more information)

Cropped to 270x200

/sample.li/birds.jpg?w=400&h=290

By default, Cloudimage crops the image centrally.

Cropped to 400x290px, keeping the left part

/sample.li/birds.jpg?w=400&h=290&gravity=west

To position the crop, use the gravity operation. Here, gravity=west means that Cloudimage will focus on the left part of the image when cropping

To focus a crop on the most prominent object on the image, you can use automatic crop.

If you need full cropping control, please see positionable crop and focal point crop.

Face crop looks for faces in the image and focuses on the most prominent one while face hide crops out the topmost part of an image if it contains a face.