camera_set_3a

Configures the autofocus, auto exposure, and auto white balance (the 3A algorithms) locks on the camera.

Synopsis:

#include <camera/camera_api.h>

camera_error_t camera_set_3a_lock(camera_handle_t handle,                 
                                  uint32_t locks)

Since:

BlackBerry 10.0.0

Arguments:

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

locks: A bitmask of 3A algorithms to lock on the camera.

Library:

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

Description:

For the locks argument, you can specify the 3A algorithms to lock by ORing values from the camera_3a_t enumerated type. The following are examples:

To unlock autofocus, auto exposure, and auto white balance, use the value of CAMERA_3A_NONE.
To lock autofocus and auto exposure and unlock auto white balance, use the value of (CAMERA_3A_AUTOFOCUS | CAMERA_3A_AUTOEXPOSURE).

Note: Not all cameras may allow the independent locking of individual 3A algorithms. For example, it may be required that auto exposure and auto white balance be locked together. Use the camera_get_3a_lock_modes() function to discover these restrictions.

The viewfinder must be running before using this function.

Returns: