camera_get_zoom_limits()

Retrieve the supported range of zoom levels and whether smooth zooming is supported by the camera.

Synopsis:

#include <camera/camera_api.h>
 
camera_error_t camera_get_zoom_limits(camera_handle_t handle,                 
                                      unsigned int *min_level,                 
                                      unsigned int *max_level,                 
                                      bool *smooth)

Since:

BlackBerry 10.0.0

Arguments:

handle

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

min_level

A pointer to an int value that will be updated with the minimal zoom level supported by the camera.

max_level

A pointer to an int value that will be updated with the maximum zoom level supported by the camera.

smooth

A pointer to a boolean value that will be updated when the call completes. A value of true indicates that smooth zooming is supported by the camera.

Library:

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

Description:

The range returned by this function represent the limits of the zoom values you can set using camera_set_zoom(). Not all cameras support smooth zooming.

If you are using CAMERA_VFMODE_DEFAULT, or if your application is running on a device which uses CAMERA_API_VERSION 2 or lower (BlackBerry 10.2.1 or older), the viewfinder must be running prior to calling this function. If you are using a different viewfinder mode, then this function may be queried prior to starting the viewfinder.

Returns:

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