Instance Property

maxAvailableVideoZoomFactor

The maximum zoom factor allowed in the current capture configuration.

Declaration

var maxAvailableVideoZoomFactor: CGFloat { get }

Discussion

On single-camera devices, this value is always equal to the device format's videoMaxZoomFactor value. On a dual-camera device, the allowed range of video zoom factors can change if the device is delivering depth data to one or more capture outputs.

Setting the videoZoomFactor property to (or calling the ramp(toVideoZoomFactor:withRate:) method with) a value greater than the device format's videoMaxZoomFactor value always raises an exception. Setting the video zoom factor to a value between the maximum available zoom factor and the device format's maximum clamps the zoom setting to the maximum available value.

This property is key-value observable.

See Also

Managing Zoom Settings

var videoZoomFactor: CGFloat

A value that controls the cropping and enlargement of images captured by the device.

func ramp(toVideoZoomFactor: CGFloat, withRate: Float)

Begins a smooth transition from the current zoom factor to another.

func cancelVideoZoomRamp()

Smoothly ends a zoom transition in progress.

var isRampingVideoZoom: Bool

A Boolean value that indicates whether a zoom transition is in progress.

var minAvailableVideoZoomFactor: CGFloat

The minimum zoom factor allowed in the current capture configuration.

var dualCameraSwitchOverVideoZoomFactor: CGFloat

The video zoom factor at which a dual camera device can automatically switch between cameras.