Instance Property

autoFocusRangeRestriction

A value controlling the allowable range for automatic focusing.

Declaration

@property(nonatomic) AVCaptureAutoFocusRangeRestriction autoFocusRangeRestriction;

Discussion

By default, a device capable of hardware focusing attempts to focus on objects at any distance. If you expect to focus primarily on near or far objects, set a range restriction to increase the speed and reduce the power consumption of automatic focusing, and to reduce the chance of focusing ambiguities.

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.

See Also

Managing Focus Settings

focusMode

The capture device’s focus mode.

- isFocusModeSupported:

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

focusPointOfInterest

The point of interest for focusing.

focusPointOfInterestSupported

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

adjustingFocus

Indicates whether the device is currently adjusting its focus setting.

smoothAutoFocusEnabled

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

smoothAutoFocusSupported

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

autoFocusRangeRestrictionSupported

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

AVCaptureFocusMode

Constants to specify the focus mode of a capture device.

AVCaptureAutoFocusRangeRestriction

Constants to specify the autofocus range of a capture device.

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software