capture_set_property_i()

Updated: May 27, 2022

Set a video frame capture property of type integer

Synopsis:

#include <vcapture/capture.h>
int capture_set_property_i(capture_context_t context,
                           uint32_t prop,
                           int32_t value)

Arguments:

context
The pointer to the video capture context.
prop
The property to set.
value
The integer value of the property specified by prop.

Library:

libcapture

Description:

This function sets a video capture property to pass to the video capture device driver.

Array resources, such as CAPTURE_PROPERTY_FRAME_FLAGS and CAPTURE_PROPERTY_FRAME_SEQNO are not allocated by default. They need to be set, then passed to the video capture driver. To do this you need to:
  • Call capture_set_property_i() for each capture property you need to set, using the CAPTURE_PROPERTY_* constants to specify the device, brightness, destination buffers, etc.
  • Call capture_set_property_p(), when you have set all the properties you need to specify, to pass a pointer to this array to the video capture library. The library stores this pointer and will update the array when appropriate.

You can instruct the video capture library to stop collecting and providing data for a property by setting the location for property in the array to NULL.

Returns:

0 if successful; or -1 if an error occurred (errno is set; refer to errno.h for more details). The return value and the value that's observed for errno may vary as they are dependent on the implementation by the library that handles your hardware.