camera_get_photovf_property()

(Deprecated) Retrieve one or more properties of the photo viewfinder

Synopsis:

#include <camera/camera_api.h>
 
camera_error_t camera_get_photovf_property(camera_handle_t handle,                 
                                           args...)

Since:

BlackBerry 10.0.0

Arguments:

handle

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

args...

A series of comma-delimited property-value pairs where each value must be a pointer a variable of the expected type.

Library:

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

Description:

Deprecated:

As of CAMERA_API_VERSION 3 (BlackBerry 10.3.0). Instead, use the camera_get_vf_property() function. For more information about new and deprecated viewfinder functionality, see Viewfinder modes.

There is no type-checking performed by the compiler, therefore, you must ensure that the value you provide for each property matches the expected data type. Data type mismatches can result in undefined behavior and may cause your application to crash.

You can specify multiple property-value pairs by delimiting them with a comma as follows:
 camera_get_photovf_property( camera_handle,
                              CAMERA_IMGPROP_WIDTH, &vf_width,
                              CAMERA_IMGPROP_HEIGHT, &vf_height,
                              CAMERA_IMGPROP_ROTATION, &vf_rotation,
                              CAMERA_IMGPROP_BURSTMODE, &burstmode,
                              CAMERA_IMGPROP_FRAMERATE, &framerate );

Returns:

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

Last modified: 2014-09-30



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

comments powered by Disqus