Definitions in camera_api.h

Updated: April 19, 2023

Preprocessor macro definitions for the camera_api.h header file in the libcamapi library

Definitions:

#include <camera/camera_api.h>
#define CAMERA_API_VERSION 3

The version of the Camera library.

The version number is used for IPC handshaking and communication between the Camera API and the OS. You can compare this macro value with the one returned by camera_get_api_version() to determine whether the runtime library is different from the version your application was compiled with. Differences may indicate potential incompatibilities.

#define CAMERA_HANDLE_INVALID (-1)

A safe-initializer value for a camera handle.

Use this value when you initialize a camera_handle_t variable, when you check that the initialization was correct and that a camera_open() call was successful, and after you close the handle.

#define CAMERA_ROLL_NAMELEN (256)

The maximum length of a file name or path returned by camera roll functions.

This value is useful for determining the largest char* buffer to allocate.

#define CAMERA_ROLL_SUFFIXLEN (64)

The maximum length of a suffix to add to filenames returned by camera roll functions.

#define CAMERA_MAX_FRAMEDESC_SIZE (256)

The maximum size, in bytes, of the frame descriptor.

#define CAMERA_LOCATION_NAMELEN (64)

The maximum length of a string returned for the camera location name.

This value is useful for determining the largest char* buffer to allocate.

#define CAMERA_VIDEO_GROUP_INVALID (-1)

A safe-initializer value for a video group ID.

Use this value when you initialize a camera_video_group_id_t variable, when you check that the initialization was correct and that a camera_create_video_group() call was successful, and after you destroy the video group associated with the ID.

Library:

libcamapi