Cropping image in various aspect ratios
13 Oct 20226 minutes to read
You can crop the desired portion of an image using the cropping tool.
Image cropping ratio
You can crop the image to various aspect ratios. The following cropping ratios are available in built-in toolbar: “
Cropping operation can be done in the following two ways:
- Enabling cropping and selecting the crop region visually.
- Entering the cropping area manually.
You can enable the cropping in the zoomed area and crop the specific position from the zoomed area.
Handling the cropping tool
ToggleCropping method in the
SfImageEditor control is used to enable and disable a cropping region placed over the image to visually choose the area for cropping.
The following code shows cropping the image to any desired size.
The following code shows cropping an image based on its original width and height.
The following code shows cropping an image based on specific ratio.
To position the cropping window with custom location, pass the desired rectangle in
ToggleCroppingmethod. Each value in the rectangle should be in offset value(0 to 100).
// For free hand cropping. editor.ToggleCropping();
// For cropping a image with its original width and height. editor.ToggleCropping(float.NaN,float.NaN);
// For cropping the image with ratio, x value as 9, and y value as 17. editor.ToggleCropping(9,17);
Rectangle rect = new Rectangle(20,20,50,50); editor.ToggleCropping(rect);
After the cropping area has been selected, the
Crop method is called, which in turn crops the selected region and displays the cropped image on the image editor.
An image can be cropped in circle or elliptical format, which could be perfect for using it as a profile picture.
ToggleCropping parameter as shown in the below code sample.
When an empty rect is specified in the parameter, a rounded rect will be formed covering the entire image and it will be either in circle or ellipse shape based on the image bounds.
// To crop an image as a circular dimension. var size = editor.ActualImageRenderedBounds; var minSize = Math.Min(size.Width, size.Height); var leftX = (size.Width - minSize) / 2; var topY = (size.Height - minSize) / 2 ; var x = (leftX * 100) / size.Width; var y = (topY * 100) / size.Height; var width = (minSize * 100) / size.Width; var height = (minSize * 100) / size.Height; editor.ToggleCropping(new Rectangle(x, y, width, height), true);
The following image show cases the circularly cropped image.
The following code shows cropping an image in elliptical format.
// To crop an image as a elliptical dimension. editor.ToggleCropping(new Rectangle(), true);
Manually enter the cropping area
To manually enter the cropping area without enabling the cropping functionality, use the overloaded
Crop(Rectangle rect) method. It can be done by defining a rectangle and passing it to the
Selecting the cropping ratio programmatically
Programmatically, you can select the desired cropping ratio from the various aspect ratios available in the built-in cropping toolbar by specifying the corresponding index of the toolbar item using the
The following code sample will add the cropping preview on the image in square shape.
To crop an image in a circle or an ellipse with a specific ratio, use
ToggleCroppingwith a ratio argument and an optional parameter of true, which specifies whether the cropping panel should be added in an elliptical or rectangle shape. The default value is false.
editor.ToggleCropping(1, 1, true);
Tilt the image
You can tilt the image from -45 to +45 degree by using the
Tilt() method. When calling the
Tilt() method, the image will be in preview state. You can zoom and pan the image in preview state. To apply this effect to the image, you can call the
Crop() method programmatically or can crop from footer toolbar cropping options.
Any action performed when the image is in Tilt preview state will reset the tilt effect of that image.
The following screenshot depicts the tilt preview state.
After tilt preview, cropping can be performed using the available cropping options.