camera_physprop_t

This enumerated type specifies the camera physical properties list

Synopsis:

#include <camera/camera_api.h>
typedef enum {
    CAMERA_PHYSPROP_END = -1,
    CAMERA_PHYSPROP_FOCALLENGTH = 0,
    CAMERA_PHYSPROP_HORIZONTALFOV,
    CAMERA_PHYSPROP_VERTICALFOV,
    CAMERA_PHYSPROP_SENSORWIDTH,
    CAMERA_PHYSPROP_SENSORHEIGHT,
    CAMERA_PHYSPROP_MAXZOOMRATIO,
    CAMERA_PHYSPROP_SENSORWIDTHPIXELS,
    CAMERA_PHYSPROP_SENSORHEIGHTPIXELS,
    CAMERA_PHYSPROP_FOCALLENGTH35MM,
    CAMERA_PHYSPROP_APERTURE,
    CAMERA_PHYSPROP_SENSORISO
} camera_physprop_t;

Data:

CAMERA_PHYSPROP_END
The end-of-list identifier.
CAMERA_PHYSPROP_FOCALLENGTH
The focal length of the lens in millimeters as a double value.
CAMERA_PHYSPROP_HORIZONTALFOV
The horizontal field of view of the camera when set to its minimum zoom factor and at its full-frame resolution.

The value (in degrees) is a double value. The horizontal axis is defined as the axis running from left to right of the device when held in its default orientation (i.e., the BlackBerry logo is upright).

CAMERA_PHYSPROP_VERTICALFOV
The vertical field of view of the camera when set to its minimum zoom factor and its full-frame resolution.

The value (in degrees) is a double value. The vertical axis is defined as the axis running from top to bottom of the device when held in its default orientation (i.e., the BlackBerry logo is upright).

CAMERA_PHYSPROP_SENSORWIDTH
The full-frame width of the imaging sensor in millimeters as a double value.

The width corresponds to the sensor axis which runs from left to right of the device when held in its default orientation (i.e., the BlackBerry logo is upright).

CAMERA_PHYSPROP_SENSORHEIGHT
The full-frame height of the imaging sensor in millimeters as a double value.

The height corresponds to the sensor axis which runs from top to bottom of the device when held in its default orientation (i.e., the BlackBerry logo is upright).

CAMERA_PHYSPROP_MAXZOOMRATIO
The magnification ratio between the maximum zoom factor and the minimum zoom factor as a double value.

For example, a ratio of 3.0 indicates that a fully zoomed-in image is expanded by a magnification factor of 3.0 times when compared with the fully zoomed-out version of the image.

CAMERA_PHYSPROP_SENSORWIDTHPIXELS
The full-frame width of the imaging sensor in pixels as a uint32_t value.

The width corresponds to the sensor axis which runs from left to right of the device when held in its default orientation (i.e., the BlackBerry logo is upright).

CAMERA_PHYSPROP_SENSORHEIGHTPIXELS
The full-frame height of the imaging sensor in pixels as a uint32_t value.

The height corresponds to the sensor axis which runs from top to bottom of the device when held in its default orientation (i.e., the BlackBerry logo is upright).

CAMERA_PHYSPROP_FOCALLENGTH35MM
The 35mm-equilvalent focal length of the lens in millimeters as a double value.
CAMERA_PHYSPROP_APERTURE
The aperture (or F-number) is expressed as the ratio of the focal length to the diameter of the entrance pupil of the lens as a double value.

If a variable aperture is supported, the value reported refers to the ratio at maximum pupil opening.

CAMERA_PHYSPROP_SENSORISO
The native sensitivity of the camera sensor expressed as a uint32_t ISO value.

The native sensitivity is defined as the effective sensitivity of the camera at unity gain.

Library:

libcamapi

Description:

These properties are used as keys for the camera_get_physical_property() function. Each key is associated with a value of the indicated type.