Crop Image — Reference
Extract a rectangle from a loaded image.
Extract a rectangle from a loaded image.
Before you begin
Section titled “Before you begin”- A supported image-processing runtime and a disposable test image. Load the named processing instance before effect, transform or Save steps.
Crop Image
Section titled “Crop Image”Extract a rectangle from a loaded image.
Settings
Section titled “Settings”| Setting | Meaning |
|---|---|
| Image | Select the named Load Image instance available earlier in this action. It is not a filename or an App Connect page component. |
| X | Horizontal placement in the current image. Start with a positive pixel coordinate such as 10. Alignment keywords and percentages have operation-specific semantics. |
| Y | Vertical placement in the current image. Start with a positive pixel coordinate. Text coordinates involve font baseline behavior and differ from a crop rectangle. |
| Width | The target width in pixels. In Resize, auto leaves this dimension proportional to the supplied height; supported percentage values refer to the current image. Use positive integers for Crop and Cover examples. |
| Height | The target height in pixels. In Resize, auto leaves this dimension proportional to the supplied width; supported percentages refer to the current image. |
Worked example
Section titled “Worked example”For an 80 × 60 image, use X 10, Y 10, Width 40 and Height 30. Save and confirm a 40 × 30 result showing the selected region.
Check the result
Section titled “Check the result”Coordinates and dimensions refer to the current processed image, so earlier resize or rotation steps change their meaning. Keep the rectangle within the image bounds. Crop removes pixels; it does not proportionally fit the full image into a new box.
Load, transform and save
Section titled “Load, transform and save”Image Processor operations run on the server. For transformations, use a named Load Image, apply the intended operations to that instance, and Save it to a deliberate path. A page image component will not automatically update just because an in-memory server instance changed. Return or persist the saved path and update the page’s source as needed.
Check your result
Section titled “Check your result”You can configure the selected image operation and inspect a saved result for the intended dimensions or visual effect.