Resizing

The Claid API allows you to set the final image size for different workflows you may have. By default, API will perform all calculations respecting the original image aspect ratio. Meaning, the image can be cropped but it won't be stretched or squeezed.
When you need a bigger size than the original image you can use upscale parameter to increase the final image resolution 
Width and Height
Specifies the size of the output image. The width and height parameter supports dynamic sizing and is based on pixels or percent values.
The default behavior of API resizing
If width and height are not specified the image size will not be changed. 
If you use default fit option(crop) and specify only one side of the image(width or height), the unspecified side remains unchanged and you get a cropped image.
If you using other fit option than default crop and specify only one side of the image(width or height), another side will be defined as auto and the final image will be resized keeping the aspect ratio.
When width and height are specified the resulting image will be resized until it fully covers the specified dimensions and gets cropped. 
The default behavior can be changed by the fit property.
​
Acceptable values:
Value
Type
Description
"auto"
string
the width will be calculated automatically to save the aspect ratio of the input image. If you set width to auto,  you should specify height in pixels or percentages.
1000
integer
Width in pixels.
"200%"
string
Percentage as a string. E.g. "200%" means that the width will double relative to the input image.
Examples
You can read more about "fit": "bounds", which is used in the following examples in Fit section​
Empty
Auto
Pixels
Percentage
JSON Body
1
"operations": {
2
    "resizing": {
3
        "width": 4000,
4
        "fit": "bounds"
5
    }
6
}
Copied!
JSON Body
1
"operations": {
2
    "resizing": {
3
        "width": "auto",
4
        "height": 4000,
5
        "fit": "bounds"
6
    }
7
}
Copied!
JSON Body
1
"operations": {
2
    "resizing": {
3
        "width": 4000,
4
        "height": 4000,
5
        "fit": "bounds"
6
    }
7
}
Copied!
JSON Body
1
"operations": {
2
    "resizing": {
3
        "width": "200%",
4
        "height": "200%",
5
        "fit": "bounds"
6
    }
7
}
Copied!
Fit
The fit parameter controls how the image will be constrained within the provided size, relative to the width and height.
Possible properties:
bounds Preserves aspect ratio. Resize the image to fit entirely within the specified region, making one dimension smaller if needed. 
cover Preserving aspect ratio. Resize the image to entirely cover the specified region, making one dimension larger if needed.
canvas Input image will be placed on the canvas established by width and height. The aspect ratio of the input image won’t change. Extra space will be filled with the background color.
crop  Scales an image until it fully covers the specified dimensions. the rest gets cropped. Fit crop support center and smart modes for cropping.
​
Possible values:
Value
Type
Description
crop
string or object
DEFAULT. 
Scales an image until it fully covers the specified width and height, the rest gets cropped. Content-aware cropping.
bounds
string
Scales an image until the bigger side reaches the edge of canvas established by width and height.
cover
string
Scales an image until the smaller side reaches the edge of canvas established by width and height.
canvas
string
Puts input image on the canvas established by width and height. Aspect ratio and size of the input image won't change. Extra space will be filled with white color.
Examples
Crop
Bounds
Cover
Canvas
JSON Body
1
"operations": {
2
    "resizing": {
3
        "width": 1440,
4
        "height": 1440,
5
	"fit": "crop"
6
    }
7
}
Copied!
JSON Body
1
"operations": {
2
    "resizing": {
3
        "width": 1440,
4
        "height": 1440,
5
	"fit": "bounds"
6
    }
7
}
Copied!
JSON Body
1
"operations": {
2
    "resizing": {
3
        "width": 1440,
4
        "height": 1440,
5
	"fit": "cover"
6
    }
7
}
Copied!
JSON Body
1
"operations": {
2
    "resizing": {
3
        "width": 1440,
4
        "height": 1440,
5
	"fit": "canvas"
6
    }
7
}
Copied!
​
Smart Crop
 Fit crop support center and smart modes for cropping.
​
Center
Smart
JSON Body
1
"operations": {
2
    "resizing": {
3
        "width": 2000,
4
        "height": 2000,
5
	"fit": { 
6
	    "crop": "center" 
7
	}
8
    }
9
}
Copied!
​
​
JSON Body
1
"operations": {
2
    "resizing": {
3
        "width": 2000,
4
        "height": 2000,
5
	"fit": { 
6
	    "crop": "smart" 
7
	}
8
    }
9
}
Copied!