camera_get_photo_property()

Retrieve the output properties for a photo.

Synopsis:

#include <camera/camera_api.h>
 

camera_error_t camera_get_photo_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 where each value must be a pointer a variable of the expected type.

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:

There is no type-checking performed by the compiler, therefore, you must ensure that the value you provide for each property 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:

 property1, &value1, property2, &value2,...

For example, you can retrieve the values in the following manner: 

 camera_get_photo_property( camera_handle,
                              CAMERA_IMGPROP_WIDTH, &vf_width,
                              CAMERA_IMGPROP_HEIGHT, &vf_height,
                              CAMERA_IMGPROP_ROTATION, &vf_rotation,
                              CAMERA_IMGPROP_STABILIZATION, &stable,
                              CAMERA_IMGPROP_FRAMERATE, &framerate,
                              CAMERA_IMGPROP_JPEGQFACTOR, &jpeq,
                              CAMERA_IMGPROP_BURSTDIVISOR, &burstdiv );

Returns:

CAMERA_EOK when the function successfully completes, otherwise another camera_error_t value that provides the reason that the call failed. If you pass a value that does not match the type required for the property, the return value does not clearly indicate the problem.

Related links