Instance Property


The point of interest for focusing.


var focusPointOfInterest: CGPoint { get set }


Setting a value for this property does not initiate a focusing operation. To focus the camera on a point of interest, first set this property’s value, then set the focusMode property to AVCaptureDevice.FocusMode.autoFocus or AVCaptureDevice.FocusMode.continuousAutoFocus.

This property’s CGPoint value uses a coordinate system where {0,0} is the top-left of the picture area and {1,1} is the bottom-right. This coordinate system is always relative to a landscape device orientation with the home button on the right, regardless of the actual device orientation. You can convert between this coordinate system and view coordinates using AVCaptureVideoPreviewLayer methods.

Before changing the value of this property, you must call lockForConfiguration() to acquire exclusive access to the device’s configuration properties. Otherwise, setting the value of this property raises an exception. When you finish configuring the device, call unlockForConfiguration() to release the lock and allow other devices to configure the settings.

This property supports Key-value observing.

See Also

Managing Focus Settings

var focusMode: AVCaptureDevice.FocusMode

The capture device’s focus mode.

func isFocusModeSupported(AVCaptureDevice.FocusMode) -> Bool

Returns a Boolean value that indicates whether the device supports the given focus mode.

var isFocusPointOfInterestSupported: Bool

Indicates whether the device supports a point of interest for focus.

var isAdjustingFocus: Bool

Indicates whether the device is currently adjusting its focus setting.

var isSmoothAutoFocusEnabled: Bool

A Boolean value that determines whether the device has smooth autofocus enabled.

var isSmoothAutoFocusSupported: Bool

A Boolean value that indicates whether the device supports smooth autofocus.

var autoFocusRangeRestriction: AVCaptureDevice.AutoFocusRangeRestriction

A value controlling the allowable range for automatic focusing.

var isAutoFocusRangeRestrictionSupported: Bool

A Boolean value that indicates whether the device supports focus range restrictions.

enum AVCaptureDevice.FocusMode

Constants to specify the focus mode of a capture device.

enum AVCaptureDevice.AutoFocusRangeRestriction

Constants to specify the autofocus range of a capture device.