camera_set_photovf_property()

(Deprecated) Configure one or more settings of the photo viewfinder

Synopsis:

#include <camera/camera_api.h>
 
camera_error_t camera_set_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.

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_set_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-value pair 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_set_vf_property( camera_handle,
                         CAMERA_IMGPROP_WIN_GROUPID, "mygroup",
                         CAMERA_IMGPROP_WIN_ID, "vfwindow",
                         CAMERA_IMGPROP_WIDTH, 720,
                         CAMERA_IMGPROP_HEIGHT, 1280,
                         CAMERA_IMGPROP_ROTATION, 270,
                         CAMERA_IMGPROP_FRAMERATE, (double)15.0 );

The following properties can't be changed while the viewfinder is running:

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-06-24



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

comments powered by Disqus