Definitions in camera_api.h

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

Definitions:

#define CAMERA_API_VERSION 3
The version of the Camera library.

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

For reference, the CAMERA_API_VERSION values can be mapped to BlackBerry 10 software releases that they first appeared in as follows:
  • CAMERA_API_VERSION 1 was introduced in BlackBerry 10.0.
  • CAMERA_API_VERSION 2 was introduced in BlackBerry 10.1.
  • CAMERA_API_VERSION 3 was introduced in BlackBerry 10.3.0. 
#define CAMERA_HANDLE_INVALID (-1)
A safe-initializer value for a camera_handle_t.

Use this value to check that correct initialization occurred and whether a call to the camera_open() function was successful. You should use this value to initialize camera handle variables, and after you close a handle. 

#define CAMERA_ROLL_NAMELEN (256)
The maximum length of a filename returned by camera-roll functions.

The value is useful for you to determine the largest char* buffer to allocate. The camera roll is a directory where photo and video files can be saved. 

#define CAMERA_MAX_FRAMEDESC_SIZE (256)
The maximum size, in bytes, of the frame descriptor.

Library:

libcamapi