---
title: "generateMaskedImage(for:imageFrom:croppedToInstancesExtent:)"
framework: vision
role: symbol
role_heading: Instance Method
path: "vision/instancemaskobservation/generatemaskedimage(for:imagefrom:croppedtoinstancesextent:)"
---

# generateMaskedImage(for:imageFrom:croppedToInstancesExtent:)

Creates a high-resolution image with everything except for the instances you specify masked out.

## Declaration

```swift
func generateMaskedImage(for instances: IndexSet, imageFrom requestHandler: ImageRequestHandler, croppedToInstancesExtent: Bool = false) throws -> CVPixelBuffer
```

## Parameters

- `instances`: An indexed set of selected instances, where 0 is the background.
- `requestHandler`: A request handler containing an image to be masked.
- `croppedToInstancesExtent`: Crops the image to the smallest rectangle containing all instances. Default is false.

## Return Value

Return Value The pixel buffer that contains the image.

## Discussion

Discussion

## See Also

### Generating a mask

- [generateMask(for:)](vision/instancemaskobservation/generatemask(for:).md)
- [generateScaledMask(for:scaledToImageFrom:)](vision/instancemaskobservation/generatescaledmask(for:scaledtoimagefrom:).md)