camera_has_feature()

Determine whether a feature is available on the camera.

Synopsis:

#include <camera/camera_api.h>
 
bool camera_has_feature(camera_handle_t handle,                 
                        camera_feature_t feature)

Since:

BlackBerry 10.0.0

Arguments:

handle

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

feature

The specific feature to query.

Library:

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

Description:

The availability of a feature does not mean that the feature is usable. For example, this function may indicate that physical flash is available, but the feature actually may not be used until the viewfinder is active. To determine if a feature can be used in the camera's current state, use the camera_can_feature() function.

Many developers may choose to use the set of available features in order to determine whether their application will function properly, or whether a different behaviour may be required. For example: if CAMERA_FEATURE_VIDEO is not supported, then they may disable any photo/video mode-switching buttons in their UI.

The set of available features may vary based on the current viewfinder mode. For more information, see Viewfinder modes.

Returns:

true when the specified feature is available on the camera, otherwise a value of false.

Last modified: 2014-09-30



Got questions about leaving a comment? Get answers from our Disqus FAQ.

comments powered by Disqus