Crop

crop - c - c_<crop type>

Value	Type	Description
crop type	string	Default Value: cover Value can be; cover contain fill crop (x,y or AI Object Position needed) thumb (AI Object Position needed) Eg. c_contain, c_crop, ... Required Parameters: width, height

Sets the crop type of image. When both width and height are provided, the original image aspect ratio might get broken. By changing crop type, you can adjust the aspect ratio.

Understand Main Crop Types

Crop Types Visualised

Original Image

https://demo.imagemash.io/woman3.jpg

Cover (default) - c_cover

Preserves the aspect ratio. Tries to cover the requested dimensions without disturbing images. Some parts of the image may get clipped off.

Gravity Center

You can use Gravity to adjust image gravity. By default, it is center. (g_center)

https://demo.imagemash.io/w_400,h_150/woman3.jpg

Face/Object Gravity

With Gravity parameter set to Face (g_face)

https://demo.imagemash.io/w_400,h_150,g_face/woman3.jpg

With Gravity parameter set to Laptop (g_laptop)

https://demo.imagemash.io/w_400,h_150,g_laptop/woman3.jpg

Gravity location

With Gravity parameter set to Top (g_t)

https://demo.imagemash.io/w_400,h_150,g_t/woman3.jpg

With Gravity parameter set to Bottom (g_b)

https://demo.imagemash.io/w_400,h_150,g_b/woman3.jpg

Contain - c_contain

Preserves the aspect ratio. Fits the whole image in the requested dimensions. If there are empty spaces, they are filled with background color (bg).

https://demo.imagemash.io/w_400,h_150,c_contain/woman3.jpg

Fill - c_fill

Ignores the aspect ratio. Stretches the image to fill empty spaces.

https://demo.imagemash.io/w_400,h_150,c_fill/woman3.jpg

Crop - c_crop

Crops a region from image.

Should either use with x,y coordinates or AI Object Gravity.

Crop with coordinates

Crop needs a region in order to work.

To satisfy this condition, we provide width, height, x, y.

https://demo.imagemash.io/w_200,h_200,x_100,y_300,c_crop/woman3.jpg

Crop + AI Object Gravity

Cropping with dimensions and AI Object Gravity

https://demo.imagemash.io/w_100,h_100,g_face,c_crop/woman3.jpg

You can also use c_crop with AI Object Gravity without width and height. It returns the detected region as a result.

https://demo.imagemash.io/g_laptop,c_crop/woman3.jpg

Thumb - c_thumb

Thumb is specifically designed to make thumbnails from images. It has special algorithms that differentiate it from Crop. Use c_thumb instead of c_crop if you are making thumbnails.

Needs AI Object gravity in order to work.

Example 1

https://demo.imagemash.io/w_200,h_200,g_face,c_thumb/woman3.jpg

Example 2

Making a rounded thumbnail from an image.

https://demo.imagemash.io/w_200,h_200,g_face,c_thumb,r_100,bo_10_skyblue/woman3.jpg

Making a banner from an image.

https://demo.imagemash.io/w_800,h_200,g_face,c_thumb,r_15,bo_5_skyblue/woman3.jpg

Hey! Take a look at Named Transforms, you can assign your transforms into custom variables.