camera_get_manual_focus

Retrieve the current manual focus lens position and range.

Synopsis:

#include <camera/camera_api.h>

camera_error_t camera_get_manual_focus_step(camera_handle_t handle,                 
                                            int *maxstep,                 
                                            int *step)

Since:

BlackBerry 10.0.0

Arguments:

handle: The handle returned by a call to the camera_open() function.

maxstep: A pointer to the returned maximum settable step value that can be used for manual focus. It also indicates the infinity focus lens position.

step: A pointer to the returned current step value (position) of the lens. The minimum step value is 0 and the maximum step is the value returned in the maxstep argument.

Library:

libcamapi (For the qcc command, use the -l camapi option to link against this library)

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 only use this function 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.

The viewfinder must be running before using this function.

Returns: