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:

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.