camera_set_videovf_property()
Configure one or more settings in the video viewfinder.
Synopsis:
#include <camera/camera_api.h>
camera_error_t camera_set_videovf_property(camera_handle_t handle, args...)
Arguments:
- handle
-
The handle returned by a call to the camera_open() function.
- args...
-
A property-value pair delimited by a comma. The property name and property value must also be delimited by a comma.
Library:
libcamapiDescription:
As part of 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:
- CAMERA_IMGPROP_WIN_GROUPID
- CAMERA_IMGPROP_WIN_ID
- CAMERA_IMGPROP_FORMAT
- CAMERA_IMGPROP_WIDTH
- CAMERA_IMGPROP_HEIGHT
- CAMERA_IMGPROP_FRAMERATE
- CAMERA_IMGPROP_ROTATION
- CAMERA_IMGPROP_HWOVERLAY
- CAMERA_IMGPROP_ZOOMFACTOR
- CAMERA_IMGPROP_MAXFOV
You can specify multiple property-value pairs by delimiting them with a comma as follows:
name1, value1, name2, value2,...
For example, you can set values in the following manner:
camera_set_videovf_property( camera_handle, CAMERA_IMGPROP_WIN_GROUPID, "GroupID", CAMERA_IMGPROP_WIN_ID, "WindowID", CAMERA_IMGPROP_WIDTH, 1024, CAMERA_IMGPROP_HEIGHT, 576, CAMERA_IMGPROP_ROTATION, 90, CAMERA_IMGPROP_FRAMERATE, (double)30.0 );
Note: The following properties can't be changed after the viewfinder has started:
- CAMERA_IMGPROP_WIN_ID
- CAMERA_IMGPROP_FORMAT
- CAMERA_IMGPROP_HWOVERLAY
- CAMERA_IMGPROP_MAXFOV You can change these properties after stopping the viewfinder. When the viewfinder is running then CAMERA_IMGPROP_WIN_GROUPID can only be set if the current value is an empty string.
Returns:
CAMERA_EOK when the function successfully completes, otherwise another camera_error_t value that provides the reason that the call failed.