---
title: AVCapturePhoto
framework: avfoundation
role: symbol
role_heading: Class
path: avfoundation/avcapturephoto
---

# AVCapturePhoto

A container for image data from a photo capture output.

## Declaration

```swift
class AVCapturePhoto
```

## Mentioned in

Configuring camera capture to collect a Portrait Effects matte Saving captured photos Capturing and saving Live Photos Capturing thumbnail and preview images Capturing a bracketed photo sequence Capturing photos with depth Capturing uncompressed image data Tracking photo capture progress

## Overview

Overview When you capture photos with the AVCapturePhotoOutput class, your delegate object receives each resulting image and related data in the form of an AVCapturePhoto object. This object is an immutable wrapper from which you can retrieve various results of the photo capture. In addition to the photo image pixel buffer, an AVCapturePhoto object can also contain a preview-sized pixel buffer, capture metadata, and, on supported devices, depth data and camera calibration data. From an AVCapturePhoto object, you can generate data appropriate for writing to a file, such as HEVC encoded image data containerized in the HEIC file format and including a preview image, depth data and other attachments. An AVCapturePhoto instance wraps a single image result. For example, if you request a bracketed capture of three images, your callback is called three times, each time delivering a single AVCapturePhoto object.

## Topics

### Resolving photo capture requests

- [resolvedSettings](avfoundation/avcapturephoto/resolvedsettings.md)
- [photoCount](avfoundation/avcapturephoto/photocount.md)
- [timestamp](avfoundation/avcapturephoto/timestamp.md)

### Accessing photo pixel data

- [isRawPhoto](avfoundation/avcapturephoto/israwphoto.md)
- [pixelBuffer](avfoundation/avcapturephoto/pixelbuffer.md)

### Accessing preview photo data

- [embeddedThumbnailPhotoFormat](avfoundation/avcapturephoto/embeddedthumbnailphotoformat.md)
- [previewPixelBuffer](avfoundation/avcapturephoto/previewpixelbuffer.md)

### Accessing photo metadata

- [depthData](avfoundation/avcapturephoto/depthdata.md)
- [cameraCalibrationData](avfoundation/avcapturephoto/cameracalibrationdata.md)
- [sourceDeviceType](avfoundation/avcapturephoto/sourcedevicetype.md)
- [metadata](avfoundation/avcapturephoto/metadata.md)
- [portraitEffectsMatte](avfoundation/avcapturephoto/portraiteffectsmatte.md)

### Packaging data for file output

- [fileDataRepresentation(with:)](avfoundation/avcapturephoto/filedatarepresentation(with:).md)
- [AVCapturePhotoFileDataRepresentationCustomizer](avfoundation/avcapturephotofiledatarepresentationcustomizer.md)
- [fileDataRepresentation()](avfoundation/avcapturephoto/filedatarepresentation().md)
- [cgImageRepresentation()](avfoundation/avcapturephoto/cgimagerepresentation().md)
- [previewCGImageRepresentation()](avfoundation/avcapturephoto/previewcgimagerepresentation().md)
- [fileDataRepresentation(withReplacementMetadata:replacementEmbeddedThumbnailPhotoFormat:replacementEmbeddedThumbnailPixelBuffer:replacementDepthData:)](avfoundation/avcapturephoto/filedatarepresentation(withreplacementmetadata:replacementembeddedthumbnailphotoformat:replacementembeddedthumbnailpixelbuffer:replacementdepthdata:).md)

### Enabling constant color

- [constantColorCenterWeightedMeanConfidenceLevel](avfoundation/avcapturephoto/constantcolorcenterweightedmeanconfidencelevel.md)
- [constantColorConfidenceMap](avfoundation/avcapturephoto/constantcolorconfidencemap.md)
- [isConstantColorFallbackPhoto](avfoundation/avcapturephoto/isconstantcolorfallbackphoto.md)

### Examining bracketed capture information

- [bracketSettings](avfoundation/avcapturephoto/bracketsettings.md)
- [sequenceCount](avfoundation/avcapturephoto/sequencecount.md)
- [lensStabilizationStatus](avfoundation/avcapturephoto/lensstabilizationstatus.md)
- [AVCaptureDevice.LensStabilizationStatus](avfoundation/avcapturedevice/lensstabilizationstatus.md)

### Accessing segmentation mattes

- [semanticSegmentationMatte(for:)](avfoundation/avcapturephoto/semanticsegmentationmatte(for:).md)

## Relationships

### Inherits From

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

### Inherited By

- [AVCaptureDeferredPhotoProxy](avfoundation/avcapturedeferredphotoproxy.md)

### Conforms To

- [CVarArg](swift/cvararg.md)
- [CustomDebugStringConvertible](swift/customdebugstringconvertible.md)
- [CustomStringConvertible](swift/customstringconvertible.md)
- [Equatable](swift/equatable.md)
- [Hashable](swift/hashable.md)
- [NSObjectProtocol](objectivec/nsobjectprotocol.md)

## See Also

### Photo capture

- [Capturing consistent color images](avfoundation/capturing-consistent-color-images.md)
- [Capturing still and Live Photos](avfoundation/capturing-still-and-live-photos.md)
- [Capturing photos in RAW and Apple ProRAW formats](avfoundation/capturing-photos-in-raw-and-apple-proraw-formats.md)
- [Supporting Continuity Camera in Your Mac App](appkit/supporting-continuity-camera-in-your-mac-app.md)
- [AVCaptureDeferredPhotoProxy](avfoundation/avcapturedeferredphotoproxy.md)
- [AVCapturePhotoOutput](avfoundation/avcapturephotooutput.md)
- [AVCapturePhotoCaptureDelegate](avfoundation/avcapturephotocapturedelegate.md)
- [AVCapturePhotoOutputReadinessCoordinator](avfoundation/avcapturephotooutputreadinesscoordinator.md)
- [AVCapturePhotoOutputReadinessCoordinatorDelegate](avfoundation/avcapturephotooutputreadinesscoordinatordelegate.md)
- [AVCaptureStillImageOutput](avfoundation/avcapturestillimageoutput.md)