---
title: AVCapturePhotoSettings
framework: avfoundation
role: symbol
role_heading: Class
path: avfoundation/avcapturephotosettings
---

# AVCapturePhotoSettings

A specification of the features and settings to use for a single photo capture request.

## Declaration

```swift
class AVCapturePhotoSettings
```

## Mentioned in

Capturing a bracketed photo sequence Capturing and saving Live Photos Capturing photos in RAW and Apple ProRAW formats Capturing photos with depth Capturing thumbnail and preview images Saving captured photos Tracking photo capture progress

## Overview

Overview To take a photo, you create and configure a AVCapturePhotoSettings object, then pass it to the AVCapturePhotoOutput capturePhoto(with:delegate:) method. A AVCapturePhotoSettings instance can include any combination of settings, regardless of whether that combination is valid for a given capture session. When you initiate a capture by passing a photo settings object to the capturePhoto(with:delegate:) method, the photo capture output validates your settings to ensure deterministic behavior. For example, the flashMode setting must specify a value that’s present in the photo output’s supportedFlashModes array. For detailed validation rules, see each property description below. important: You can’t reuse a AVCapturePhotoSettings instance for multiple captures. Calling the capturePhoto(with:delegate:) method throws an exception (invalidArgumentException) if the settings object’s uniqueID value matches that of any previously used settings object. To reuse a specific combination of settings, use the init(from:) initializer to create a new, unique AVCapturePhotoSettings instance from an existing photo settings object.

## Topics

### Creating photo settings

- [init(format:)](avfoundation/avcapturephotosettings/init(format:).md)
- [init(rawPixelFormatType:)](avfoundation/avcapturephotosettings/init(rawpixelformattype:).md)
- [init(rawPixelFormatType:processedFormat:)](avfoundation/avcapturephotosettings/init(rawpixelformattype:processedformat:).md)
- [init(rawPixelFormatType:rawFileType:processedFormat:processedFileType:)](avfoundation/avcapturephotosettings/init(rawpixelformattype:rawfiletype:processedformat:processedfiletype:).md)
- [init(from:)](avfoundation/avcapturephotosettings/init(from:).md)

### Inspecting settings

- [uniqueID](avfoundation/avcapturephotosettings/uniqueid.md)
- [format](avfoundation/avcapturephotosettings/format.md)
- [processedFileType](avfoundation/avcapturephotosettings/processedfiletype.md)
- [rawFileType](avfoundation/avcapturephotosettings/rawfiletype.md)
- [rawPhotoPixelFormatType](avfoundation/avcapturephotosettings/rawphotopixelformattype.md)

### Configuring photo settings

- [flashMode](avfoundation/avcapturephotosettings/flashmode.md)
- [isAutoRedEyeReductionEnabled](avfoundation/avcapturephotosettings/isautoredeyereductionenabled.md)
- [maxPhotoDimensions](avfoundation/avcapturephotosettings/maxphotodimensions.md)
- [photoQualityPrioritization](avfoundation/avcapturephotosettings/photoqualityprioritization.md)
- [isCameraCalibrationDataDeliveryEnabled](avfoundation/avcapturephotosettings/iscameracalibrationdatadeliveryenabled.md)
- [isAutoContentAwareDistortionCorrectionEnabled](avfoundation/avcapturephotosettings/isautocontentawaredistortioncorrectionenabled.md)
- [isAutoVirtualDeviceFusionEnabled](avfoundation/avcapturephotosettings/isautovirtualdevicefusionenabled.md)
- [virtualDeviceConstituentPhotoDeliveryEnabledDevices](avfoundation/avcapturephotosettings/virtualdeviceconstituentphotodeliveryenableddevices.md)
- [isDualCameraDualPhotoDeliveryEnabled](avfoundation/avcapturephotosettings/isdualcameradualphotodeliveryenabled.md)
- [isAutoDualCameraFusionEnabled](avfoundation/avcapturephotosettings/isautodualcamerafusionenabled.md)
- [isAutoStillImageStabilizationEnabled](avfoundation/avcapturephotosettings/isautostillimagestabilizationenabled.md)
- [isHighResolutionPhotoEnabled](avfoundation/avcapturephotosettings/ishighresolutionphotoenabled.md)

### Suppressing the shutter sound

- [isShutterSoundSuppressionEnabled](avfoundation/avcapturephotosettings/isshuttersoundsuppressionenabled.md)

### Enabling preview and thumbnail delivery

- [previewPhotoFormat](avfoundation/avcapturephotosettings/previewphotoformat.md)
- [availablePreviewPhotoPixelFormatTypes](avfoundation/avcapturephotosettings/availablepreviewphotopixelformattypes-30d9.md)
- [embeddedThumbnailPhotoFormat](avfoundation/avcapturephotosettings/embeddedthumbnailphotoformat.md)
- [availableRawEmbeddedThumbnailPhotoCodecTypes](avfoundation/avcapturephotosettings/availablerawembeddedthumbnailphotocodectypes.md)
- [rawEmbeddedThumbnailPhotoFormat](avfoundation/avcapturephotosettings/rawembeddedthumbnailphotoformat.md)
- [availableEmbeddedThumbnailPhotoCodecTypes](avfoundation/avcapturephotosettings/availableembeddedthumbnailphotocodectypes.md)

### Configuring Live Photo settings

- [livePhotoMovieFileURL](avfoundation/avcapturephotosettings/livephotomoviefileurl.md)
- [livePhotoMovieMetadata](avfoundation/avcapturephotosettings/livephotomoviemetadata.md)
- [livePhotoVideoCodecType](avfoundation/avcapturephotosettings/livephotovideocodectype.md)

### Configuring constant color

- [isConstantColorEnabled](avfoundation/avcapturephotosettings/isconstantcolorenabled.md)
- [isConstantColorFallbackPhotoDeliveryEnabled](avfoundation/avcapturephotosettings/isconstantcolorfallbackphotodeliveryenabled.md)

### Capturing depth data

- [isDepthDataDeliveryEnabled](avfoundation/avcapturephotosettings/isdepthdatadeliveryenabled.md)
- [embedsDepthDataInPhoto](avfoundation/avcapturephotosettings/embedsdepthdatainphoto.md)
- [isDepthDataFiltered](avfoundation/avcapturephotosettings/isdepthdatafiltered.md)

### Capturing Portrait Effects matte

- [isPortraitEffectsMatteDeliveryEnabled](avfoundation/avcapturephotosettings/isportraiteffectsmattedeliveryenabled.md)
- [embedsPortraitEffectsMatteInPhoto](avfoundation/avcapturephotosettings/embedsportraiteffectsmatteinphoto.md)

### Capturing semantic segmentation mattes

- [embedsSemanticSegmentationMattesInPhoto](avfoundation/avcapturephotosettings/embedssemanticsegmentationmattesinphoto.md)
- [enabledSemanticSegmentationMatteTypes](avfoundation/avcapturephotosettings/enabledsemanticsegmentationmattetypes.md)

### Embedding metadata

- [metadata](avfoundation/avcapturephotosettings/metadata.md)

### Instance properties

- [rawFileFormat](avfoundation/avcapturephotosettings/rawfileformat.md)

### Initializers

- [init(fromPhotoSettings:)](avfoundation/avcapturephotosettings/init(fromphotosettings:).md)

## Relationships

### Inherits From

- [NSObject](objectivec/nsobject-swift.class.md)

### Inherited By

- [AVCapturePhotoBracketSettings](avfoundation/avcapturephotobracketsettings.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

- [AVCapturePhotoBracketSettings](avfoundation/avcapturephotobracketsettings.md)
- [AVCaptureResolvedPhotoSettings](avfoundation/avcaptureresolvedphotosettings.md)