<!--
{
  "availability" : [
    "iOS: 27.0.0 -",
    "iPadOS: 27.0.0 -",
    "macCatalyst: 27.0.0 -",
    "macOS: 27.0.0 -",
    "tvOS: 27.0.0 -",
    "visionOS: 27.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "CoreImage",
  "identifier" : "/documentation/CoreImage/CIImageProcessorKernel/apply(tiledExtent:inputs:arguments:)",
  "metadataVersion" : "0.1.0",
  "role" : "Type Method",
  "symbol" : {
    "kind" : "Type Method",
    "modules" : [
      "Core Image",
      "CoreImage"
    ],
    "preciseIdentifier" : "c:objc(cs)CIImageProcessorKernel(cm)applyWithTiledExtent:inputs:arguments:error:"
  },
  "title" : "apply(tiledExtent:inputs:arguments:)"
}
-->

# apply(tiledExtent:inputs:arguments:)

Call this method on your Core Image Processor Kernel subclass to create a new image
based on an array of tile extents that together cover the output.

```
class func apply(tiledExtent tileExtents: [CIVector], inputs: [CIImage]?, arguments args: [String : Any]?) throws -> CIImage
```

## Parameters

`tileExtents`

The array of bounding rectangles that the `CIImageProcessorKernel` can produce.
Each rectangle in the array is an object created using `/CIVector/vectorWithCGRect:`
This method will return `CIImage.emptyImage` if the rectangles in the array
have gaps or overlaps.

`inputs`

An array of [`CIImage`](/documentation/CoreImage/CIImage) objects to use as input.

## Return Value


An autoreleased [`CIImage`](/documentation/CoreImage/CIImage)

## Discussion

Each tile is a CGRect encoded as a CIVector using +[CIVector vectorWithCGRect:].
The overall output extent is computed as the union of all tile extents.

This method will return `nil` and an error if:

- calling [`outputFormat`](/documentation/CoreImage/CIImageProcessorKernel/outputFormat) on your subclass returns an unsupported format.
- calling [`formatForInput(at:)`](/documentation/CoreImage/CIImageProcessorKernel/formatForInput(at:)) on your subclass returns an unsupported format.
- your subclass does not implement [`process(with:arguments:output:)`](/documentation/CoreImage/CIImageProcessorKernel/process(with:arguments:output:))

---

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)