camera_physprop

This enumerated type specifies the camera physical properties list.

Synopsis:

#include <camera/camera_api.h>

typedef enum {
      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;

Since:

BlackBerry 10.0.0

Data:

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.

Since: BlackBerry 10.3.0

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.

Since: BlackBerry 10.3.0

Library:

libcamapi (For the qcc command, use the -l camapi option to link against this library)

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.