camera_physprop_t

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.

Last modified: 2014-06-24



Got questions about leaving a comment? Get answers from our Disqus FAQ.

comments powered by Disqus