camera_set_vf_property()

Synopsis:

#include <camera/camera_api.h>

camera_error_t camera_set_vf_property(camera_handle_t handle,
                                      args...)

Arguments:

handle: The handle returned by a call to the camera_open() function.
args...: A series of comma-delimited property-value pairs.

Library:

libcamapi

Description:

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 values 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:

When the viewfinder is running, then CAMERA_IMGPROP_WIN_GROUPID can only be changed if the current value is an empty string.

Note:

The following properties can't be changed while a non-video 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.