v1 Image Transformations - Cropping Images

You can crop images by entering coordinates for where the boundary of the crop will be.

Filepicker has a limit to how large the images it will accept for conversions can be. The maximum accepted image size is 100,000,000 pixels, so an image with this many pixels could have width and height combinations like 10,000 x 10,000 or 5,000 x 20,000, etc.

Crop and Resize: If you are trying to combine crop and resize parameters, you need to add the crop_first=true parameter if you want to ensure that the crop happens before other conversions happen.

Syntax

https://www.filestackapi.com/api/file/<handle>/convert?[options]
crop

Crops the image to a specified rectangle.

The input to this parameter must have exactly 4 numbers: 'x,y,width,height' - for example, crop=10,20,200,250 crops a 200x250 pixel rectangle starting at 10 pixels from the left edge and 20 pixels from the top edge of the image.
crop_first

Makes sure the image is cropped before any other conversion parameters are executed.

The only value for this parameter is crop_first=true

Examples

Original image

width = 400px, height = 300px

the original image to be resized

Image cropped to specific width and height starting from the left, top corner

width = 200px, height = 150px, starting point = (0,0)

the source image cropped starting from (0,0), the top left corner of the image

Image cropped to specific width and height starting from a specific point

width = 200px, height = 150px, starting point = (50,100)

the original source image cropped to a width and height of 200x150 from a specific point