---
title: VNImageRequestHandler
framework: vision
role: symbol
role_heading: Class
path: vision/vnimagerequesthandler
---

# VNImageRequestHandler

An object that processes one or more image-analysis request pertaining to a single image.

## Declaration

```swift
class VNImageRequestHandler
```

## Mentioned in

Detecting Human Body Poses in Images Identifying 3D human body poses in images Recognizing Text in Images

## Overview

Overview Instantiate this handler to perform Vision requests on a single image. You specify the image and, optionally, a completion handler at the time of creation, and call perform(_:) to begin executing the request.

## Topics

### Creating a Request Handler

- [init(cgImage:options:)](vision/vnimagerequesthandler/init(cgimage:options:)-4qda6.md)
- [init(cgImage:orientation:options:)](vision/vnimagerequesthandler/init(cgimage:orientation:options:)-63ojm.md)
- [init(ciImage:options:)](vision/vnimagerequesthandler/init(ciimage:options:)-4wf33.md)
- [init(ciImage:orientation:options:)](vision/vnimagerequesthandler/init(ciimage:orientation:options:)-3svy6.md)
- [init(cvPixelBuffer:options:)](vision/vnimagerequesthandler/init(cvpixelbuffer:options:)-bkd7.md)
- [init(cvPixelBuffer:orientation:options:)](vision/vnimagerequesthandler/init(cvpixelbuffer:orientation:options:)-9fxug.md)
- [init(cvPixelBuffer:depthData:orientation:options:)](vision/vnimagerequesthandler/init(cvpixelbuffer:depthdata:orientation:options:)-3mj2d.md)
- [init(cmSampleBuffer:options:)](vision/vnimagerequesthandler/init(cmsamplebuffer:options:)-2yodn.md)
- [init(cmSampleBuffer:orientation:options:)](vision/vnimagerequesthandler/init(cmsamplebuffer:orientation:options:)-335k4.md)
- [init(cmSampleBuffer:depthData:orientation:options:)](vision/vnimagerequesthandler/init(cmsamplebuffer:depthdata:orientation:options:)-8bjyh.md)
- [init(data:options:)](vision/vnimagerequesthandler/init(data:options:).md)
- [init(data:orientation:options:)](vision/vnimagerequesthandler/init(data:orientation:options:).md)
- [init(url:options:)](vision/vnimagerequesthandler/init(url:options:)-4k623.md)
- [init(url:orientation:options:)](vision/vnimagerequesthandler/init(url:orientation:options:)-70nta.md)

### Executing a Request Handler

- [perform(_:)](vision/vnimagerequesthandler/perform(_:).md)

### Setting Image Options

- [VNImageOption](vision/vnimageoption.md)

### Initializers

- [init(CGImage:options:)](vision/vnimagerequesthandler/init(cgimage:options:)-5tp19.md)
- [init(CGImage:orientation:options:)](vision/vnimagerequesthandler/init(cgimage:orientation:options:)-8imhf.md)
- [init(CIImage:options:)](vision/vnimagerequesthandler/init(ciimage:options:)-55zel.md)
- [init(CIImage:orientation:options:)](vision/vnimagerequesthandler/init(ciimage:orientation:options:)-8p8h1.md)
- [init(CMSampleBuffer:depthData:orientation:options:)](vision/vnimagerequesthandler/init(cmsamplebuffer:depthdata:orientation:options:)-yi6q.md)
- [init(CMSampleBuffer:options:)](vision/vnimagerequesthandler/init(cmsamplebuffer:options:)-4mpwd.md)
- [init(CMSampleBuffer:orientation:options:)](vision/vnimagerequesthandler/init(cmsamplebuffer:orientation:options:)-6qeht.md)
- [init(CVPixelBuffer:depthData:orientation:options:)](vision/vnimagerequesthandler/init(cvpixelbuffer:depthdata:orientation:options:)-3u960.md)
- [init(CVPixelBuffer:options:)](vision/vnimagerequesthandler/init(cvpixelbuffer:options:)-3pee9.md)
- [init(CVPixelBuffer:orientation:options:)](vision/vnimagerequesthandler/init(cvpixelbuffer:orientation:options:)-160f.md)
- [init(URL:options:)](vision/vnimagerequesthandler/init(url:options:)-19t0u.md)
- [init(URL:orientation:options:)](vision/vnimagerequesthandler/init(url:orientation:options:)-ou7m.md)

## Relationships

### Inherits From

- [NSObject](objectivec/nsobject-swift.class.md)

### Conforms To

- [CVarArg](swift/cvararg.md)
- [CustomDebugStringConvertible](swift/customdebugstringconvertible.md)
- [CustomStringConvertible](swift/customstringconvertible.md)
- [Equatable](swift/equatable.md)
- [Hashable](swift/hashable.md)
- [NSObjectProtocol](objectivec/nsobjectprotocol.md)

## See Also

### Still-image analysis

- [Detecting Objects in Still Images](vision/detecting-objects-in-still-images.md)
- [Classifying images for categorization and search](vision/classifying-images-for-categorization-and-search.md)
- [Analyzing Image Similarity with Feature Print](vision/analyzing-image-similarity-with-feature-print.md)
- [VNRequest](vision/vnrequest.md)
- [VNImageBasedRequest](vision/vnimagebasedrequest.md)
- [VNClassifyImageRequest](vision/vnclassifyimagerequest.md)
- [VNGenerateImageFeaturePrintRequest](vision/vngenerateimagefeatureprintrequest.md)
- [VNFeaturePrintObservation](vision/vnfeatureprintobservation.md)
- [VNObservation](vision/vnobservation.md)