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.

For the args argument, you can provide one or more property-value pairs using camera_imgprop_t values as the name of the property and the correct type for the value such as an int or double value. The following camera_imgprop_t can be used with this function:
Note: 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 );
Note: 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.

Parent topic: Functions in camera_api.h