camera_set_videoencoder_parameter()

Configure the video encoder parameters

Synopsis:

#include <camera/camera_encoder.h>
camera_set_videoencoder_parameter(camera_handle_t handle,
                                  args...)

Arguments:

handle
The handle returned by a call to the camera_open() function.
args...
A series of comma-delimited parameter-value pairs.

Library:

libcamapi

Description:

Use this function to configure the video encoder before you start to encode or record video. To encode or record video, call the camera_start_video() or the camera_start_encode() function. The parameters that you can configure depend on the codec you selected using camera_set_video_property().

For the args argument, you can provide one or more parameter-value pairs using the parameter enumerations defined by the following enumerated types:

Multiple parameter-value pairs are delimited using a comma. The parameter that you choose depends on the video codec you want to use. For example, for the H.264/AVC codec, you use the parameter enumerations defined in camera_h264avc_parameters_t enumerated type and the correct type for the value, such as an int or double.

You can specify multiple parameter-value pairs by delimiting them with a comma as follows:
camera_set_videoencoder_parameter( camera_handle,
                  CAMERA_H264AVC_BITRATE, 1000000,
                  CAMERA_H264AVC_KEYFRAMEINTERVAL, 60,
                  CAMERA_H264AVC_RATECONTROLCAMERA_H264AVC_RATECONTROL_CBR,
                  CAMERA_H264AVC_PROFILECAMERA_H264AVC_PROFILE_HIGH,
                  CAMERA_H264AVC_LEVELCAMERA_H264AVC_LEVEL_4 );

Returns:

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