Crop images

Crop images to remove unwanted areas or adjust aspect ratios. Specify cropping parameters in request URLs to crop images onEdge Security Accelerator (ESA) points of presence (POPs).

Parameters

image_process=crop or circle.

Supported parameters:

Note

If any parameter is negative, the original image is returned unchanged.

Parameter	Description	Valid values
w	Width of the crop area.	Default: 0. Maximum total pixels: 16,777,216.
h	Height of the crop area.
x	X coordinate of the crop area. Defaults to the upper-left corner of the image.
y	Y coordinate of the crop area. Defaults to the upper-left corner of the image.
g	Crop position in a 3×3 grid. Each tile is identified by its upper-left corner.	nw: upper left north: upper middle ne: upper right west: middle left center: center east: middle right sw: lower left south: lower middle se: lower right Grid positions are shown in the following figure.

Tile positions in a 3×3 grid:

Image cropping

Examples

Supported cropping methods and examples:

Method	Description	Example
Crop in a circle shape	Specify a radius to crop the image into a circle. The radius cannot exceed half the shorter side of the image.	`http(s)://example.com/image01.png?image_process=circle,200`
Crop in a 3 by 3 grid	Divide the image into a 3×3 grid and crop a specific tile by position.	`http(s)://example.com/image01.png?image_process=crop,w_200,h_200,g_se`
Crop based on an X and Y coordinate	Specify the X and Y coordinates of the lower-left corner, plus the width and height, to define the crop area.	`http(s)://example.com/image01.png?image_process=crop,x_10,y_10,w_400,h_200`
Crop from the center	Specify the width and height to crop equally from all four sides.	`http(s)://example.com/image01.png?image_process=crop,mid,w_400,h_200`