start_preview_func_t

Updated: April 19, 2023

Start preview (the viewfinder) with the desired configuration

Synopsis:

#include <camera/external_camera_api.h>
typedef int(* start_preview_func_t)(void *handle,
            camera_preview_params_t *params,
            camera_buffer_list_t *buflist);

Arguments:

handle
The handle that's returned from calling the function open_external_camera_func_t.
params
A set of preview parameters (e.g., resolution, rotation, frame rate); see camera_preview_params_t.
buflist
A pointer to a complete list of the buffers which will be used for preview; see camera_buffer_list_t.

Library:

libcamapi

Description:

This function is called to start preview (the viewfinder). The function configures the camera to start producing preview frames that are consumed by an upper-layer thread, which repeatedly calls into the blocking function get_preview_frame_func_t.

Note:

Some cameras need to know the details of all buffers that will be used prior to starting the preview. For this reason, you can provide a complete list of buffers in buflist when starting preview.

Returns:

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