<!--
{
  "availability" : [
    "iOS: 7.0.0 -",
    "iPadOS: 7.0.0 -",
    "macCatalyst: 14.0.0 -",
    "macOS: 10.7.0 -",
    "tvOS: 17.0.0 -",
    "visionOS: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "AVFoundation",
  "identifier" : "/documentation/AVFoundation/AVCaptureDevice/Format",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "AVFoundation"
    ],
    "preciseIdentifier" : "c:objc(cs)AVCaptureDeviceFormat"
  },
  "title" : "AVCaptureDevice.Format"
}
-->

# AVCaptureDevice.Format

A class that defines media formats and capture settings that capture devices support.

```
class Format
```

## Overview

A format object provides information about a media capture format to use with a capture device, such as video frame rates and zoom factors.

You can find more information about a capture format using its associated Core Media format description (see <doc://com.apple.documentation/documentation/CoreMedia/CMFormatDescription>), available using the [`formatDescription`](/documentation/AVFoundation/AVCaptureDevice/Format/formatDescription) property.

## Topics

### Determining spatial capture support

[`isSpatialVideoCaptureSupported`](/documentation/AVFoundation/AVCaptureDevice/Format/isSpatialVideoCaptureSupported)

A Boolean value that indicates whether the format supports capturing spatial video to a file.

### Determining background replacement support

[`isBackgroundReplacementSupported`](/documentation/AVFoundation/AVCaptureDevice/Format/isBackgroundReplacementSupported)

A Boolean value that indicates whether the format supports background replacement.

[`videoFrameRateRangeForBackgroundReplacement`](/documentation/AVFoundation/AVCaptureDevice/Format/videoFrameRateRangeForBackgroundReplacement)

The minimum and maximum frame rates available when Background Replacement is active.

### Determining video capture support

[`isAutoVideoFrameRateSupported`](/documentation/AVFoundation/AVCaptureDevice/Format/isAutoVideoFrameRateSupported)

A Boolean value that Indicates whether the format supports performing automatic video frame rate adjustments.

[`videoSupportedFrameRateRanges`](/documentation/AVFoundation/AVCaptureDevice/Format/videoSupportedFrameRateRanges)

A list of frame rate ranges that a format supports.

[`AVFrameRateRange`](/documentation/AVFoundation/AVFrameRateRange)

An immutable type that represents a range of valid frame rates.

[`isVideoBinned`](/documentation/AVFoundation/AVCaptureDevice/Format/isVideoBinned)

A Boolean value that indicates whether the format produces video data in a binned format.

[`isVideoHDRSupported`](/documentation/AVFoundation/AVCaptureDevice/Format/isVideoHDRSupported)

A Boolean value that indicates whether the format supports high dynamic range streaming.

[`isMultiCamSupported`](/documentation/AVFoundation/AVCaptureDevice/Format/isMultiCamSupported)

A Boolean value that indicates whether a multi-camera capture session supports this format.

### Determining reaction effects support

[`reactionEffectsSupported`](/documentation/AVFoundation/AVCaptureDevice/Format/reactionEffectsSupported)

A Boolean value that indicates whether the device supports reaction effects.

[`videoFrameRateRangeForReactionEffectsInProgress`](/documentation/AVFoundation/AVCaptureDevice/Format/videoFrameRateRangeForReactionEffectsInProgress)

Indicates the minimum and maximum frame rates available when a reaction effect runs.

### Determining supported media formats

[`mediaType`](/documentation/AVFoundation/AVCaptureDevice/Format/mediaType)

A constant describing the media type of an `AVCaptureDevice` active or supported format.

[`formatDescription`](/documentation/AVFoundation/AVCaptureDevice/Format/formatDescription)

An object describing the capture format.

### Determining output support

[`unsupportedCaptureOutputClasses`](/documentation/AVFoundation/AVCaptureDevice/Format/unsupportedCaptureOutputClasses)

The list of capture output subclasses not allowed for capture with this format, if any.

### Determining field of view

[`videoFieldOfView`](/documentation/AVFoundation/AVCaptureDevice/Format/videoFieldOfView)

Indicates the format’s horizontal field of view in degrees.

[`geometricDistortionCorrectedVideoFieldOfView`](/documentation/AVFoundation/AVCaptureDevice/Format/geometricDistortionCorrectedVideoFieldOfView)

A horizontal field of view for the format after correction for geometric distortion.

### Determining video stabilization support

[`isVideoStabilizationModeSupported(_:)`](/documentation/AVFoundation/AVCaptureDevice/Format/isVideoStabilizationModeSupported(_:))

A Boolean value that indicates whether the format supports a given video stabilization mode.

[`AVCaptureVideoStabilizationMode`](/documentation/AVFoundation/AVCaptureVideoStabilizationMode)

An enumeration of video stabilization modes that capture devices and formats support.

### Determining photo quality

[`supportedMaxPhotoDimensions`](/documentation/AVFoundation/AVCaptureDevice/Format/supportedMaxPhotoDimensions)

The maximum photo dimension this format supports.

[`supportedMaxPhotoDimensions`](/documentation/AVFoundation/AVCaptureDeviceFormat/supportedMaxPhotoDimensions)

The maximum photo dimension this format supports.

[`isHighPhotoQualitySupported`](/documentation/AVFoundation/AVCaptureDevice/Format/isHighPhotoQualitySupported)

A Boolean value that indicates whether this format supports high-quality capture with the current quality prioritization setting.

[`isHighestPhotoQualitySupported`](/documentation/AVFoundation/AVCaptureDevice/Format/isHighestPhotoQualitySupported)

A Boolean value that indicates whether this format supports the highest photo quality that the platform delivers.

### Determining color support

[`isGlobalToneMappingSupported`](/documentation/AVFoundation/AVCaptureDevice/Format/isGlobalToneMappingSupported)

A Boolean value that indicates whether the format supports global tone mapping.

[`supportedColorSpaces`](/documentation/AVFoundation/AVCaptureDevice/Format/supportedColorSpaces)

The list of the device’s supported color spaces.

[`supportedColorSpaces`](/documentation/AVFoundation/AVCaptureDeviceFormat/supportedColorSpaces)

The list of color spaces the format supports for image and video capture.

### Determining exposure support

[`systemRecommendedExposureBiasRange`](/documentation/AVFoundation/AVCaptureDevice/Format/systemRecommendedExposureBiasRange)

The system’s recommended exposure bias range for this device format.

[`systemRecommendedExposureBiasRange`](/documentation/AVFoundation/AVCaptureDeviceFormat/systemRecommendedExposureBiasRange)

The system’s recommended exposure bias range for this device format.

[`AVExposureBiasRange`](/documentation/AVFoundation/AVExposureBiasRange)

An object that expresses an inclusive range of supported exposure bias values, in EV units.

[`minISO`](/documentation/AVFoundation/AVCaptureDevice/Format/minISO)

A floating-point number that indicates the minimum supported exposure ISO value.

[`maxISO`](/documentation/AVFoundation/AVCaptureDevice/Format/maxISO)

A floating-point number that indicates the maximum supported exposure ISO value.

[`minExposureDuration`](/documentation/AVFoundation/AVCaptureDevice/Format/minExposureDuration)

A time value that indicates the minimum supported exposure duration.

[`maxExposureDuration`](/documentation/AVFoundation/AVCaptureDevice/Format/maxExposureDuration)

A time value that indicates the maximum supported exposure duration.

### Determining zoom capabilities

[`systemRecommendedVideoZoomRange`](/documentation/AVFoundation/AVCaptureDevice/Format/systemRecommendedVideoZoomRange)

The system’s recommended zoom range for this device format.

[`systemRecommendedVideoZoomRange`](/documentation/AVFoundation/AVCaptureDeviceFormat/systemRecommendedVideoZoomRange)

The system’s recommended zoom range for this device format.

[`videoMaxZoomFactor`](/documentation/AVFoundation/AVCaptureDevice/Format/videoMaxZoomFactor)

A maximum zoom factor the format allows.

[`videoZoomFactorUpscaleThreshold`](/documentation/AVFoundation/AVCaptureDevice/Format/videoZoomFactorUpscaleThreshold)

A threshold at which the system upscales pixel data.

[`secondaryNativeResolutionZoomFactors`](/documentation/AVFoundation/AVCaptureDevice/Format/secondaryNativeResolutionZoomFactors)

The zoom factors at which this device transitions to secondary native resolution modes.

[`supportedVideoZoomRangesForDepthDataDelivery`](/documentation/AVFoundation/AVCaptureDevice/Format/supportedVideoZoomRangesForDepthDataDelivery)

The zoom ranges that support the delivery of depth data.

[`secondaryNativeResolutionZoomFactors`](/documentation/AVFoundation/AVCaptureDeviceFormat/secondaryNativeResolutionZoomFactors)

The zoom factors at which this device transitions to secondary native resolution modes.

[`supportedVideoZoomRangesForDepthDataDelivery`](/documentation/AVFoundation/AVCaptureDeviceFormat/supportedVideoZoomRangesForDepthDataDelivery)

The zoom ranges that support the delivery of depth data.

[`AVZoomRange`](/documentation/AVFoundation/AVZoomRange)

An object that defines an inclusive range of zoom values.

[`zoomFactorsOutsideOfVideoZoomRangesForDepthDeliverySupported`](/documentation/AVFoundation/AVCaptureDevice/Format/zoomFactorsOutsideOfVideoZoomRangesForDepthDeliverySupported)

A Boolean value that indicates whether the format supports zoom factors outside the range supported for depth delivery.

### Determining the auto focus system

[`autoFocusSystem`](/documentation/AVFoundation/AVCaptureDevice/Format/autoFocusSystem-swift.property)

The auto focus system the format uses.

[`AVCaptureDevice.Format.AutoFocusSystem`](/documentation/AVFoundation/AVCaptureDevice/Format/AutoFocusSystem-swift.enum)

An enumeration of auto focus systems.

### Determining Cinematic video support

[`isCinematicVideoCaptureSupported`](/documentation/AVFoundation/AVCaptureDevice/Format/isCinematicVideoCaptureSupported)

Indicates whether the format supports Cinematic Video capture.

[`defaultSimulatedAperture`](/documentation/AVFoundation/AVCaptureDevice/Format/defaultSimulatedAperture)

Default shallow depth of field simulated aperture.

[`minSimulatedAperture`](/documentation/AVFoundation/AVCaptureDevice/Format/minSimulatedAperture)

Minimum supported shallow depth of field simulated aperture.

[`maxSimulatedAperture`](/documentation/AVFoundation/AVCaptureDevice/Format/maxSimulatedAperture)

Maximum supported shallow depth of field simulated aperture.

[`videoMaxZoomFactorForCinematicVideo`](/documentation/AVFoundation/AVCaptureDevice/Format/videoMaxZoomFactorForCinematicVideo)

Indicates the maximum zoom factor available for the [`videoZoomFactor`](/documentation/AVFoundation/AVCaptureDevice/videoZoomFactor) property when Cinematic Video capture is enabled on the device input.

[`videoMinZoomFactorForCinematicVideo`](/documentation/AVFoundation/AVCaptureDevice/Format/videoMinZoomFactorForCinematicVideo)

Indicates the minimum zoom factor available for the [`videoZoomFactor`](/documentation/AVFoundation/AVCaptureDevice/videoZoomFactor) property when Cinematic Video capture is enabled on the device input.

[`videoFrameRateRangeForCinematicVideo`](/documentation/AVFoundation/AVCaptureDevice/Format/videoFrameRateRangeForCinematicVideo)

Indicates the minimum / maximum frame rates available when Cinematic Video capture is enabled on the device input.

### Determining lens smudge detection support

[`isCameraLensSmudgeDetectionSupported`](/documentation/AVFoundation/AVCaptureDevice/Format/isCameraLensSmudgeDetectionSupported)

Whether camera lens smudge detection is supported.

### Determining smart framing support

[`isSmartFramingSupported`](/documentation/AVFoundation/AVCaptureDevice/Format/isSmartFramingSupported)

Returns `true` if smart framing is supported by the current format.

### Determining dynamic aspect ratio support

[`supportedDynamicAspectRatios`](/documentation/AVFoundation/AVCaptureDevice/Format/supportedDynamicAspectRatios)

Indicates the supported aspect ratios for the device format.

[`videoFieldOfView(for:geometricDistortionCorrected:)`](/documentation/AVFoundation/AVCaptureDevice/Format/videoFieldOfView(for:geometricDistortionCorrected:))

Indicates the horizontal field of view for an aspect ratio, either uncorrected or corrected for geometric distortion.

### Determining Center Stage support

[`isCenterStageSupported`](/documentation/AVFoundation/AVCaptureDevice/Format/isCenterStageSupported)

A Boolean value that indicates whether the format supports Center Stage.

[`videoFrameRateRangeForCenterStage`](/documentation/AVFoundation/AVCaptureDevice/Format/videoFrameRateRangeForCenterStage)

The range of frame rates available when Center Stage is active.

[`videoMinZoomFactorForCenterStage`](/documentation/AVFoundation/AVCaptureDevice/Format/videoMinZoomFactorForCenterStage)

The minimum zoom factor available when Center Stage is active.

[`videoMaxZoomFactorForCenterStage`](/documentation/AVFoundation/AVCaptureDevice/Format/videoMaxZoomFactorForCenterStage)

The maximum zoom factor available when Center Stage is active.

### Determining Portrait Effects support

[`isPortraitEffectSupported`](/documentation/AVFoundation/AVCaptureDevice/Format/isPortraitEffectSupported)

A Boolean value that indicates whether the format supports the Portrait Effect feature.

[`isPortraitEffectsMatteStillImageDeliverySupported`](/documentation/AVFoundation/AVCaptureDevice/Format/isPortraitEffectsMatteStillImageDeliverySupported)

A Boolean indicating whether the device supports portrait matte effects in still-image capture.

[`videoFrameRateRangeForPortraitEffect`](/documentation/AVFoundation/AVCaptureDevice/Format/videoFrameRateRangeForPortraitEffect)

The range of frame rates available when Portrait Effect is active.

### Determining Studio Light support

[`isStudioLightSupported`](/documentation/AVFoundation/AVCaptureDevice/Format/isStudioLightSupported)

A Boolean value that indicates whether the format supports Studio Light.

[`videoFrameRateRangeForStudioLight`](/documentation/AVFoundation/AVCaptureDevice/Format/videoFrameRateRangeForStudioLight)

A value that indicates the minimum and maximum frame rates available when a user enables Studio Light.

### Determining depth capture support

[`supportedDepthDataFormats`](/documentation/AVFoundation/AVCaptureDevice/Format/supportedDepthDataFormats)

The list of data formats compatible with this video format.

[`supportedVideoZoomFactorsForDepthDataDelivery`](/documentation/AVFoundation/AVCaptureDevice/Format/supportedVideoZoomFactorsForDepthDataDelivery)

The zoom factors that a format supports for depth data delivery.

### Deprecated

[Deprecated symbols](/documentation/AVFoundation/avcapturedevice-format-deprecated-symbols)

Review unsupported symbols and their replacements.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)