Set video frame capture properties.
Synopsis:
#include <vcapture/capture.h>
int capture_set_property_i( capture_context_t context,
uint32_t prop, int32_t value )
Arguments:
- context
- Pointer to the video capture context.
- prop
- The property to set.
- value
- The integer value of the property.
Library:
libcapture
Description:
The function
capture_set_property_i() sets video capture properties 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.
- When you have set all the properties you need to specify, call capture_set_property_p() 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
- Success.
- -1
- An error occurred (errno is set).
Errors:
- EINVAL
- Bad value or values.
- ENOENT
- The specified property can't be set by this method.
- ENOTSUP
- The driver or the device doesn't support the specified property.
- EROFS
- Unable to change read-only property.