<!--
{
  "availability" : [
    "iOS: 17.0.0 -",
    "iPadOS: 17.0.0 -",
    "macCatalyst: 17.0.0 -",
    "macOS: 14.0.0 -",
    "tvOS: 17.0.0 -",
    "visionOS: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "CreateMLComponents",
  "identifier" : "/documentation/CreateMLComponents/RandomImageCropper",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "Create ML Components"
    ],
    "preciseIdentifier" : "s:18CreateMLComponents18RandomImageCropperV"
  },
  "title" : "RandomImageCropper"
}
-->

# RandomImageCropper

Crops an image at a random location.

```
struct RandomImageCropper
```

## Topics

### Creating an image cropper

[`init(scale: ClosedRange<Double>, aspectRatio: Double?)`](/documentation/CreateMLComponents/RandomImageCropper/init(scale:aspectRatio:))

Creates an augmentation that crops an input image at a random location with a scale that indicates the lower
and upper bounds to randomly scale the height and width of the image. The range must be between 0 and 1.

[`init(targetSize: CGSize)`](/documentation/CreateMLComponents/RandomImageCropper/init(targetSize:))

Creates an augmentation that crops an input image at a random location to the specified target size.

[`init(targetWidth: Double, targetHeight: Double)`](/documentation/CreateMLComponents/RandomImageCropper/init(targetWidth:targetHeight:))

Creates an augmentation that crops an input image at a random location to the specified target width and
height.

### Performing the augmentation

[`func applied(to: CIImage, generator: inout some RandomNumberGenerator, eventHandler: EventHandler?) async throws -> CIImage`](/documentation/CreateMLComponents/RandomImageCropper/applied(to:generator:eventHandler:))

Randomly crops an image at a random location of a given size.

## Relationships

### Conforms To

[`RandomTransformer`](/documentation/CreateMLComponents/RandomTransformer)

[`SendableMetatype`](/documentation/Swift/SendableMetatype)

[`Sendable`](/documentation/Swift/Sendable)

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)