Enumeration

AVCaptureAutoFocusRangeRestriction

Constants to specify the autofocus range of a capture device.

Declaration

typedef enum AVCaptureAutoFocusRangeRestriction : NSInteger {
    ...
} AVCaptureAutoFocusRangeRestriction;

Overview

If you expect to focus primarily on near or far objects, you can use the autoFocusRangeRestriction property to provide a hint to the focusing system. This approach makes autofocus faster, more power efficient, and less error prone. A restriction prioritizes focusing at distances in the specified range, but does not prevent focusing elsewhere if the device finds no focus point within that range.

Topics

Constants

AVCaptureAutoFocusRangeRestrictionNone

The device attempts to focus on objects at any range.

AVCaptureAutoFocusRangeRestrictionNear

The device primarily attempts to focus on subjects near the camera.

AVCaptureAutoFocusRangeRestrictionFar

The device primarily attempts to focus on subjects far away from the camera.

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.

autoFocusRangeRestriction

A value controlling the allowable range for automatic focusing.

autoFocusRangeRestrictionSupported

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

AVCaptureFocusMode

Constants to specify the focus mode 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