<!--
{
  "availability" : [
    "iOS: 11.0.0 -",
    "iPadOS: 11.0.0 -",
    "macCatalyst: 13.1.0 -",
    "macOS: 10.13.0 -",
    "tvOS: 11.0.0 -",
    "visionOS: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Vision",
  "identifier" : "/documentation/Vision/VNTargetedImageRequest",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "Vision"
    ],
    "preciseIdentifier" : "c:objc(cs)VNTargetedImageRequest"
  },
  "title" : "VNTargetedImageRequest"
}
-->

# VNTargetedImageRequest

The abstract superclass for image analysis requests that operate on both the processed image and a secondary image.

```
class VNTargetedImageRequest
```

## Overview

Other Vision request handlers that operate on both the processed image and a secondary image inherit from this abstract base class. Instantiate one of its subclasses to perform image analysis, and pass in auxiliary image data by filling in the `options` dictionary at initialization.

## Topics

### Creating a Request

[`initWithTargetedCGImage:options:`](/documentation/Vision/VNTargetedImageRequest/initWithTargetedCGImage:options:)

Creates a new request targeting a Core Graphics image.

[`init(targetedCGImage:options:completionHandler:)`](/documentation/Vision/VNTargetedImageRequest/init(targetedCGImage:options:completionHandler:))

Creates a new request targeting a Core Graphics image, executing the completion handler when done.

[`initWithTargetedCGImage:orientation:options:`](/documentation/Vision/VNTargetedImageRequest/initWithTargetedCGImage:orientation:options:)

Creates a new request targeting a Core Graphics image of known orientation.

[`init(targetedCGImage:orientation:options:completionHandler:)`](/documentation/Vision/VNTargetedImageRequest/init(targetedCGImage:orientation:options:completionHandler:))

Creates a new request targeting a Core Graphics image of known orientation, executing the completion handler when done.

[`initWithTargetedCIImage:options:`](/documentation/Vision/VNTargetedImageRequest/initWithTargetedCIImage:options:)

Creates a new request targeting a Core Image image.

[`init(targetedCIImage:options:completionHandler:)`](/documentation/Vision/VNTargetedImageRequest/init(targetedCIImage:options:completionHandler:))

Creates a new request targeting a Core Image image.

[`initWithTargetedCIImage:orientation:options:`](/documentation/Vision/VNTargetedImageRequest/initWithTargetedCIImage:orientation:options:)

Creates a new request targeting a Core Image image of known orientation.

[`init(targetedCIImage:orientation:options:completionHandler:)`](/documentation/Vision/VNTargetedImageRequest/init(targetedCIImage:orientation:options:completionHandler:))

Creates a new request targeting a Core Image image of known orientation, executing the completion handler when done.

[`initWithTargetedCVPixelBuffer:options:`](/documentation/Vision/VNTargetedImageRequest/initWithTargetedCVPixelBuffer:options:)

Creates a new request targeting an image in a pixel buffer.

[`init(targetedCVPixelBuffer:options:completionHandler:)`](/documentation/Vision/VNTargetedImageRequest/init(targetedCVPixelBuffer:options:completionHandler:))

Creates a new request targeting an image in a pixel buffer.

[`initWithTargetedCVPixelBuffer:orientation:options:`](/documentation/Vision/VNTargetedImageRequest/initWithTargetedCVPixelBuffer:orientation:options:)

Creates a new request targeting an image in a pixel buffer of known orientation.

[`init(targetedCVPixelBuffer:orientation:options:completionHandler:)`](/documentation/Vision/VNTargetedImageRequest/init(targetedCVPixelBuffer:orientation:options:completionHandler:))

Creates a new request targeting an image in a pixel buffer of known orientation.

[`initWithTargetedCMSampleBuffer:options:`](/documentation/Vision/VNTargetedImageRequest/initWithTargetedCMSampleBuffer:options:)

Creates a new request that targets an image in a sample buffer.

[`init(targetedCMSampleBuffer:options:completionHandler:)`](/documentation/Vision/VNTargetedImageRequest/init(targetedCMSampleBuffer:options:completionHandler:))

Creates a new request with a completion handler that targets an image in a sample buffer.

[`initWithTargetedCMSampleBuffer:orientation:options:`](/documentation/Vision/VNTargetedImageRequest/initWithTargetedCMSampleBuffer:orientation:options:)

Creates a new request that targets an image of a known orientation in a sample buffer.

[`init(targetedCMSampleBuffer:orientation:options:completionHandler:)`](/documentation/Vision/VNTargetedImageRequest/init(targetedCMSampleBuffer:orientation:options:completionHandler:))

Creates a new request with a completion handler that targets an image of a known orientation in a sample buffer.

[`initWithTargetedImageData:options:`](/documentation/Vision/VNTargetedImageRequest/initWithTargetedImageData:options:)

Creates a new request targeting an image as raw data.

[`init(targetedImageData:options:completionHandler:)`](/documentation/Vision/VNTargetedImageRequest/init(targetedImageData:options:completionHandler:))

Creates a new request targeting an image as raw data, executing the completion handler when done.

[`initWithTargetedImageData:orientation:options:`](/documentation/Vision/VNTargetedImageRequest/initWithTargetedImageData:orientation:options:)

Creates a new request targeting a raw data image of known orientation.

[`init(targetedImageData:orientation:options:completionHandler:)`](/documentation/Vision/VNTargetedImageRequest/init(targetedImageData:orientation:options:completionHandler:))

Creates a new request targeting a raw data image of known orientation, executing the completion handler when done.

[`initWithTargetedImageURL:options:`](/documentation/Vision/VNTargetedImageRequest/initWithTargetedImageURL:options:)

Creates a new request targeting an image at the specified URL.

[`init(targetedImageURL:options:completionHandler:)`](/documentation/Vision/VNTargetedImageRequest/init(targetedImageURL:options:completionHandler:))

Creates a new request targeting an image at the specified URL, executing the completion handler when done.

[`initWithTargetedImageURL:orientation:options:`](/documentation/Vision/VNTargetedImageRequest/initWithTargetedImageURL:orientation:options:)

Creates a new request targeting an image of known orientation, at the specified URL.

[`init(targetedImageURL:orientation:options:completionHandler:)`](/documentation/Vision/VNTargetedImageRequest/init(targetedImageURL:orientation:options:completionHandler:))

Creates a new request targeting an image of known orientation, at the specified URL, executing the completion handler when done.



---

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)