Skip to main content

Intelligent Crop

Intelligent crop is a smart cropping and resizing service. It uses various ML models for smart cropping as well as image processing techniques to provide seamless cropping and resizing experience.


Params

Required width (w)

The required width of the output image (this value should not be greater than the actual image width). w is an alias of this parameter.

Required height (h)

The required height of the output image (this value should not be greater than the actual image height). h is an alias of this parameter.

Padding percentage (p)

it adds extra space around the cropped image. p is an alias for this parameter.

For example, suppose padding 40% is applied on face cropping. If the earlier crop dimension was 100x100, the new dimension will become 140x140 covering more regions in the crop.

Padding can’t increase dimensions more than the original image size.

Pot and Cuporiginal
Cropped cupic.crop(g:object,obj:cup)
Cropped cup with paddingic.crop(g:object,obj:cup,p:40)

Maintain original aspect (ma)

If even after cropping the image, you need to maintain the same aspect ratio, this checkbox will save you from calculating exact dimensions, and do it for you. If you want a specific dimension, just pass either the width or the height parameter, or don’t pass to get the original aspect only. ma is an alias of this parameter.

If both height and width parameters are passed, or if the aspect ratio parameter is passed then the maintain original aspect parameter will be ignored.

Pot and Cuporiginal
Cropped cupic.crop(g:object,obj:cup)
Cropped cup with maintained aspect ratioic.crop(g:object,obj:cup,ma:true)

Aspect ratio (ar)

Allows the user to specify the aspect ratio of the output image. ar is an alias of this parameter.

You can enter custom aspect ratio in flexible formats (e.g. [w_h] or [divided value of w/h] 16_9 or 2 or 0.25).

If both height and width parameters are passed, then the aspect ratio parameter will be ignored. For example, if the height is 100 and the width is 100, then the aspect becomes 1:1, which will override everything passed by the user.

Pot and Cuporiginal
Cropped cupic.crop(g:object,obj:cup)
Cropped cup with 2 aspect ratioic.crop(g:object,obj:cup,ar:2)
Cropped cup with 16:9 aspect ratioic.crop(g:object,obj:cup,ar:16_9)

Gravity towards (g)

Allows the user to choose the main focus of the output image. g is an alias of this parameter.

It allows the user to select between the following options: object, foreground, face, or none. The default value is none.

If multiple items are found for the selected option, the resultant image will contain all the items. If none are found, then the original image will be returned.

Preferred direction (d)

Allows the user to select multiple preferred output image directions. d is an alias of this parameter.

Valid values are north_west, north, north_east, west, center, east, south_west, south, and south_east. The default value is the center.

For example, in the detected object crop of a model, you want the 100x100 crop of shoes part, changing the direction from the center to south will give a crop from the bottom, for hairs choose north and so on.

Object type (obj)

Allows the user to choose which object to focus on. obj is an alias of this parameter.

This option is only available if the object option in the Gravity towards parameter is selected.

From including but not limited to cars, skateboards, and sheep with over 80+ objects to choose from, gives you the crop containing your required object. If you have multiple objects in the same image, it will intelligently cover all the objects in your crop.

Open to see all available object type

airplane, apple, backpack, banana, baseball_bat, baseball_glove, bear, bed, bench, bicycle, bird, boat, book, bottle, bowl, broccoli, bus, cake, car, carrot, cat, cell_phone, chair, clock, couch, cow, cup, dining_table, dog, donut, elephant, fire_hydrant, fork, frisbee, giraffe, hair_drier, handbag, horse, hot_dog, keyboard, kite, knife, laptop, microwave, motorcycle, mouse, orange, oven, parking_meter, person, pizza, potted_plant, refrigerator, remote, sandwich, scissors, sheep, sink, skateboard, skis, snowboard, spoon, sports_ball, stop_sign, suitcase, surfboard, teddy_bear, tennis_racket, tie, toaster, toilet, toothbrush, traffic_light, train, truck, tv, umbrella, vase, wine_glass, zebra


info

Along with providing a transformed image, the Intelligent Crop transformation also provides contextual information about the transformation. Go to Context to learn more.

Is this page useful?