---
title: VNGeneratePersonSegmentationRequest
framework: vision
role: symbol
role_heading: Class
path: vision/vngeneratepersonsegmentationrequest
---

# VNGeneratePersonSegmentationRequest

An object that produces a matte image for a person it finds in the input image.

## Declaration

```swift
class VNGeneratePersonSegmentationRequest
```

## Overview

Overview Perform this request to detect and generate an image mask for a person in an image. The request returns the resulting image mask in an instance of VNPixelBufferObservation.

## Topics

### Creating a Request

- [init()](vision/vngeneratepersonsegmentationrequest/init().md)
- [init(completionHandler:)](vision/vngeneratepersonsegmentationrequest/init(completionhandler:).md)

### Configuring the Request

- [outputPixelFormat](vision/vngeneratepersonsegmentationrequest/outputpixelformat.md)
- [qualityLevel](vision/vngeneratepersonsegmentationrequest/qualitylevel-swift.property.md)
- [VNGeneratePersonSegmentationRequest.QualityLevel](vision/vngeneratepersonsegmentationrequest/qualitylevel-swift.enum.md)

### Getting the supported output pixel formats

- [supportedOutputPixelFormats()](vision/vngeneratepersonsegmentationrequest/supportedoutputpixelformats().md)

### Accessing the Results

- [results](vision/vngeneratepersonsegmentationrequest/results.md)
- [VNPixelBufferObservation](vision/vnpixelbufferobservation.md)

### Identifying Request Revisions

- [VNGeneratePersonSegmentationRequestRevision1](vision/vngeneratepersonsegmentationrequestrevision1.md)

## Relationships

### Inherits From

- [VNStatefulRequest](vision/vnstatefulrequest.md)

### Conforms To

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

## See Also

### Image sequence analysis

- [Applying Matte Effects to People in Images and Video](vision/applying-matte-effects-to-people-in-images-and-video.md)
- [Detecting human actions in a live video feed](createml/detecting-human-actions-in-a-live-video-feed.md)
- [Segmenting and colorizing individuals from a surrounding scene](vision/segmenting-and-colorizing-individuals-from-a-surrounding-scene.md)
- [VNStatefulRequest](vision/vnstatefulrequest.md)
- [VNGeneratePersonInstanceMaskRequest](vision/vngeneratepersoninstancemaskrequest.md)
- [VNDetectDocumentSegmentationRequest](vision/vndetectdocumentsegmentationrequest.md)
- [VNSequenceRequestHandler](vision/vnsequencerequesthandler.md)