camera_get_physical_property()

Retrieve one or more physical properties of the camera.

Synopsis:

#include <camera/camera_api.h>

camera_error_t camera_get_physical_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 pointer to the appropriate C 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.

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_physical_property(camera_handle,
                              CAMERA_PHYSPROP_FOCALLENGTH, &focalLength,
                              CAMERA_PHYSPROP_HORIZONTALFOV, &horizFov);

Returns:

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