camera_create_video_group()

Updated: April 19, 2023

Create a video group for synchronized video recording/encoding

Synopsis:

#include <camera/camera_api.h>
camera_error_t camera_create_video_group(uint32_t max_entries,
                                         camera_video_group_id_t *group_id)

Arguments:

max_entries
The maximum number of entries that can belong to this video group at any time.
group_id
On success, the returned ID that uniquely identifies the newly created group (see camera_video_group_id_t).

Library:

libcamapi

Description:

This function creates a video group, which permits multiple cameras to start and stop a video recording or encoding simultaneously. After creating a video group, you need to register the handles of the cameras that need to belong to the group, by calling camera_add_video_group_entry() for each.

When the video group is no longer required, you need to call camera_destroy_video_group() to release it.

Returns:

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