---
title: GenerateForegroundInstanceMaskRequest
framework: vision
role: symbol
role_heading: Structure
path: vision/generateforegroundinstancemaskrequest
---

# GenerateForegroundInstanceMaskRequest

A request that generates an instance mask of noticeable objects to separate from the background.

## Declaration

```swift
struct GenerateForegroundInstanceMaskRequest
```

## Overview

Overview This request generates an InstanceMaskObservation object with instance-mask data.

## Topics

### Creating a request

- [init(_:)](vision/generateforegroundinstancemaskrequest/init(_:).md)

### Performing a request

- [perform(on:orientation:)](vision/imageprocessingrequest/perform(on:orientation:)-80bya.md)
- [perform(on:orientation:)](vision/imageprocessingrequest/perform(on:orientation:)-3f3f1.md)
- [perform(on:orientation:)](vision/imageprocessingrequest/perform(on:orientation:)-qxxx.md)
- [perform(on:orientation:)](vision/imageprocessingrequest/perform(on:orientation:)-xspx.md)
- [perform(on:orientation:)](vision/imageprocessingrequest/perform(on:orientation:)-3hddl.md)
- [perform(on:orientation:)](vision/imageprocessingrequest/perform(on:orientation:)-85ex1.md)

### Understanding the result

- [InstanceMaskObservation](vision/instancemaskobservation.md)

### Getting the revision

- [revision](vision/generateforegroundinstancemaskrequest/revision-swift.property.md)
- [supportedRevisions](vision/generateforegroundinstancemaskrequest/supportedrevisions.md)
- [GenerateForegroundInstanceMaskRequest.Revision](vision/generateforegroundinstancemaskrequest/revision-swift.enum.md)

## Relationships

### Conforms To

- [CustomStringConvertible](swift/customstringconvertible.md)
- [Equatable](swift/equatable.md)
- [Hashable](swift/hashable.md)
- [ImageProcessingRequest](vision/imageprocessingrequest.md)
- [Sendable](swift/sendable.md)
- [SendableMetatype](swift/sendablemetatype.md)
- [VisionRequest](vision/visionrequest.md)

## See Also

### Image segmentation and subject lifting

- [Segmenting objects using taps, scribbles or rectangles](vision/segmenting-objects-using-taps-scribbles-or-rectangles.md)
- [GeneratePersonInstanceMaskRequest](vision/generatepersoninstancemaskrequest.md)
- [GeneratePersonSegmentationRequest](vision/generatepersonsegmentationrequest.md)