camera_set_scene_mode()

Change the scene mode on the camera.

Synopsis:

#include <camera/camera_api.h>
 

camera_error_t camera_set_scene_mode(camera_handle_t handle, camera_scenemode_t mode)

Arguments:

handle

The handle returned by a call to the camera_open() function.

mode

The desired scene mode to set the camera to.

Library:

libcamapi

Description:

You specify the scene mode to set using the mode argument. The viewfinder must be active prior to setting the scene mode. Use camera_get_scene_modes() to determine the focus modes that are supported for the current platform and camera.

Some scene modes override previously configured parameters. For example, if you set the scene mode to CAMERA_SCENE_NIGHT , it may override the programmed frame rate in order to achieve better low-light performance. In this situation, you can change the scene mode to another mode other than CAMERA_SCENE_NIGHT to restore the frame rate back to its configured value
.

Returns:

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

Related links