camera_set_photovf_property()

Configure one or more settings in the photo viewfinder.

Synopsis:

#include <camera/camera_api.h>
 

camera_error_t camera_set_photovf_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:

libcamapi

Description:

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_BURSTMODE
  • CAMERA_IMGPROP_VARIABLEFRAMERATE
  • CAMERA_IMGPROP_MINFRAMERATE

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_photovf_property( camera_handle,
                                CAMERA_IMGPROP_WIN_GROUPID, "mygroup",
                                CAMERA_IMGPROP_WIN_ID, "vfwindow",
                                CAMERA_IMGPROP_WIDTH, 1024,
                                CAMERA_IMGPROP_HEIGHT, 576,
                                CAMERA_IMGPROP_ROTATION, 90,
                                CAMERA_IMGPROP_BURSTMODE, 1,
                                CAMERA_IMGPROP_FRAMERATE, (double)15.0,
                                CAMERA_IMGPROP_HWOVERLAY, 0,
                                CAMERA_IMGPROP_ZOOMFACTOR, 20 );

Returns:

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

Related links