camera_get_photovf_property()

Retrieve one or more properties of the photo viewfinder.

Synopsis:

#include <camera/camera_api.h>
 
camera_error_t camera_get_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 and the value must be a reference.

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 a pointer to 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_FORMAT
  • CAMERA_IMGPROP_WIDTH
  • CAMERA_IMGPROP_HEIGHT
  • CAMERA_IMGPROP_FRAMERATE
  • CAMERA_IMGPROP_ROTATION
  • CAMERA_IMGPROP_FRAMERATE
  • 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 get values in the following manner:
   camera_get_photovf_property( camera_handle,
                                CAMERA_IMGPROP_WIDTH, &vf_width,
                                CAMERA_IMGPROP_HEIGHT, &vf_height,
                                CAMERA_IMGPROP_ROTATION, &vf_rotation,
                                CAMERA_IMGPROP_BURSTMODE, &burstmode,
                                CAMERA_IMGPROP_FRAMERATE, &framerate,
                                CAMERA_IMGPROP_HWOVERLAY, &hwoverlay,
                                CAMERA_IMGPROP_ZOOMFACTOR, &zoomfactor );

Returns:

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