---
title: centerStageRectOfInterest
framework: avfoundation
role: symbol
role_heading: Instance Property
path: avfoundation/avcapturedevice/centerstagerectofinterest
---

# centerStageRectOfInterest

The effective region within the output pixel buffer to perform Center Stage framing.

## Declaration

```swift
var centerStageRectOfInterest: CGRect { get set }
```

## Discussion

Discussion Apps that require cropping the output from Center Stage can use this property to guide how it performs its framing. The rectangle’s origin is top-left and is relative to the coordinate space of the output pixel buffer. The default value of this property is a rectangle with a normalized (0-1) coordinate space, where (0,0) represents the top left of the picture area, and (1,1) represents the bottom-right of the unrotated picture. The system applies the rectangle of interest prior to rotation, mirroring, or scaling. note: Setting this property has no impact on the configuration or output of AVCaptureMetadataOutput instances that you associate with a capture session. Attempting to set a rectangle of interest in the following cases results in the system throwing an illegal argument exception: If none of the capture device’s supported formats support Center Stage. If the capture device’s isCenterStageEnabled property value is false. If you specify a value that’s outside the normalized (0-1)  coordinate space. important: Before changing the value of this property, you must call lockForConfiguration() to acquire exclusive access to the device’s configuration properties. Otherwise, setting the value of this property raises an exception. When you’re done configuring the device, call unlockForConfiguration() to release the lock.

## See Also

### Configuring Center Stage

- [isCenterStageActive](avfoundation/avcapturedevice/iscenterstageactive.md)
- [isCenterStageEnabled](avfoundation/avcapturedevice/iscenterstageenabled.md)
- [centerStageControlMode](avfoundation/avcapturedevice/centerstagecontrolmode-swift.type.property.md)
- [AVCaptureDevice.CenterStageControlMode](avfoundation/avcapturedevice/centerstagecontrolmode-swift.enum.md)