Positionable crop

Allows to crop an image with a non-centred focal point. It is extremely useful when you want to crop a specific part of the image, like for example a face for a profile picture. To set the coordinates of the crop rectangle, use the tl_px or/and br_px operations.

tl_px=X1,Y1

br_px=X2,Y2

To set the final size, you can use the width or/and height operations as described below.

Original image


Specify exact crop area

You can specify the top left and bottom right pixel of the crop rectangle. The image can be then resized to desired width.

/v7/sample.li/kids.jpg?w=200&tl_px=900,0&br_px=1300,600

operation description example
tl_px top left pixel coordinates tl_px=900,0
br_px bottom right pixel coordinates br_px=1300,600
w final image width w=200

Specify only one crop corner

If you specify only top left or bottom right corner coordinates, the image is cropped and resized to the specified width or height, keeping proportions.

/v7/sample.li/kids.jpg?w=300&br_px=890,560

Combining positionable crop with resize modes

If you specify an exact crop rectangle, you can use all available resize modes - fit, bound or cover. For full details, see resize modes.

/v7/sample.li/kids.jpg?w=490&h=170&tl_px=310,70&br_px=1550,580&func=fit&bg_color=3498db

operation description example
w final width w=490
h final height h=170
tl_px top left corner coordinates tl_px=310,70
br_px bottom right corner coordinates br_px=1550,580
func resize mode func=fit
bg_color background color bg_color=3498db