camera_set_capture_property()

Updated: April 19, 2023

Set a property of an analog camera

Synopsis:

#include <camera/camera_api.h>
camera_error_t camera_set_capture_property(camera_handle_t handle,
                                           uint32_t prop,
                                           int32_t value)

Arguments:

handle
The handle returned by a call to the camera_open() function.
prop
The property to set. See the Properties section in the Video Capture Developer's Guide for the valid values.
value
The value to write for this property.

Library:

libcamapi

Description:

Use this function to set a property that is specific to analog cameras using the Video Capture API. The camera needs to support the CAMERA_FEATURE_ANALOGCAMERA feature for you to use this function on it. This function is equivalent to calling capture_set_property_i() from the video capture framework. For more information, see the Video Capture API chapter in the Video Capture Developer's Guide.

Note:

To ensure the proper operation of the camera, the writing of some capture properties is not permitted because it may interfere with other configurable properties of the camera. If an attempt to write a property isn't permitted, there is no effect on the camera and this function returns CAMERA_EOPNOTSUPP.

Returns:

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