camera_get_manual_focus_step()

Updated: April 19, 2023

Retrieve the current manual focus lens position and range

Synopsis:

#include <camera/camera_3a.h>
camera_error_t camera_get_manual_focus_step(camera_handle_t handle,
                                            int *maxstep,
                                            int *step)

Arguments:

handle
The handle returned by a call to the camera_open() function.
maxstep
A pointer to an integer that will store the maximum step value that can be used for manual focus. This value also indicates the infinity focus lens position.
step
A pointer to an integer that will store the current step value (position) of the lens. The minimum step value is 0 and the maximum is the one returned in maxstep.

Library:

libcamapi

Description:

Use this function to query the current position of the lens in manual focus mode and the maximum step value supported by camera_set_manual_focus_step().

You can use this function only when the CAMERA_FEATURE_MANUALFOCUS feature is available. You can determine whether this feature is available by calling the camera_can_feature() function.

Before you can use this function to retrieve the range of accepted values, you need to set the camera to CAMERA_FOCUSMODE_MANUAL using the camera_set_focus_mode() function.

Returns:

CAMERA_EOK when the function successfully completes, otherwise another camera_error_t value that provides the reason that the call failed.