---
title: AVCapturePhotoBracketSettings
framework: avfoundation
role: symbol
role_heading: Class
path: avfoundation/avcapturephotobracketsettings
---

# AVCapturePhotoBracketSettings

A specification of the features and settings to use for a photo capture request that captures multiple images with varied settings.

## Declaration

```swift
class AVCapturePhotoBracketSettings
```

## Mentioned in

Capturing a bracketed photo sequence

## Overview

Overview To take a bracketed capture, you create and configure an AVCapturePhotoBracketSettings object, using AVCaptureBracketedStillImageSettings objects to describe the individual captures in the bracket, and then pass it to the AVCapturePhotoOutput capturePhoto(with:delegate:) method. To request a bracketed capture, follow these steps: Create an array of AVCaptureBracketedStillImageSettings objects describing the number of images to capture in the bracket and the variations on capture settings between them. Create a bracketed photo settings object with the init(rawPixelFormatType:processedFormat:bracketedSettings:) initializer, passing the array of bracketed still image settings, along with the processed format (such as JPEG) or RAW format to capture images in. Configure other settings to share across all images in the bracket, such as the isLensStabilizationEnabled property and certain inherited properties. important: Bracketed capture supports only the isHighResolutionPhotoEnabled and previewPhotoFormat settings defined by the AVCapturePhotoSettings superclass. Bracketed capture does not support flash, auto stabilization, or Live Photos—attempting to set any of the corresponding properties raises an exception. Initiate capture by passing the bracketed photo settings object to your photo output’s capturePhoto(with:delegate:) method, along with a delegate object to receive messages about the progress and results of the capture. tip: Capturing a multiple-image bracket may require allocation of additional resources. See the setPreparedPhotoSettingsArray(_:completionHandler:) method. The photo output calls your delegate’s photoOutput(_:didFinishProcessingPhoto:previewPhoto:resolvedSettings:bracketSettings:error:) or photoOutput(_:didFinishProcessingRawPhoto:previewPhoto:resolvedSettings:bracketSettings:error:) methods many times corresponding to the number of captures in the bracket. Each call provides the AVCaptureBracketedStillImageSettings object indicating which capture in the bracket the captured image corresponds to. The following code example illustrates capturing a bracket of three RAW images with varying exposure value settings. Listing 1. Capturing a Multi-Exposure Bracket

## Topics

### Creating a bracket settings object

- [init(rawPixelFormatType:rawFileType:processedFormat:processedFileType:bracketedSettings:)](avfoundation/avcapturephotobracketsettings/init(rawpixelformattype:rawfiletype:processedformat:processedfiletype:bracketedsettings:).md)
- [init(rawPixelFormatType:processedFormat:bracketedSettings:)](avfoundation/avcapturephotobracketsettings/init(rawpixelformattype:processedformat:bracketedsettings:).md)

### Working with bracketed settings

- [bracketedSettings](avfoundation/avcapturephotobracketsettings/bracketedsettings.md)
- [isLensStabilizationEnabled](avfoundation/avcapturephotobracketsettings/islensstabilizationenabled.md)

### Bracketed settings types

- [AVCaptureAutoExposureBracketedStillImageSettings](avfoundation/avcaptureautoexposurebracketedstillimagesettings.md)
- [AVCaptureManualExposureBracketedStillImageSettings](avfoundation/avcapturemanualexposurebracketedstillimagesettings.md)
- [AVCaptureBracketedStillImageSettings](avfoundation/avcapturebracketedstillimagesettings.md)

## Relationships

### Inherits From

- [AVCapturePhotoSettings](avfoundation/avcapturephotosettings.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

### Photo settings

- [AVCapturePhotoSettings](avfoundation/avcapturephotosettings.md)
- [AVCaptureResolvedPhotoSettings](avfoundation/avcaptureresolvedphotosettings.md)