<!--
{
  "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/applied(to:generator:eventHandler:)",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Method",
  "symbol" : {
    "kind" : "Instance Method",
    "modules" : [
      "Create ML Components"
    ],
    "preciseIdentifier" : "s:18CreateMLComponents18RandomImageCropperV7applied2to9generator12eventHandlerSo7CIImageCAI_xzyAA5EventVYbcSgtYaKSGRzlF"
  },
  "title" : "applied(to:generator:eventHandler:)"
}
-->

# applied(to:generator:eventHandler:)

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

```
func applied(to image: CIImage, generator: inout some RandomNumberGenerator, eventHandler: EventHandler? = nil) async throws -> CIImage
```

## Parameters

`image`

The input image.

`generator`

A random number generator.

`eventHandler`

An event handler.

## Return Value

The cropped image.

---

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)