Camera physical properties
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 its full-frame resolution.
The value (in degrees) is a double value.
- 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.
- CAMERA_PHYSPROP_SENSORWIDTH
- The full-frame width of the imaging sensor in millimeters, as a double value.
- CAMERA_PHYSPROP_SENSORHEIGHT
- The full-frame height of the imaging sensor in millimeters, as a double value.
- 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.
- CAMERA_PHYSPROP_SENSORHEIGHTPIXELS
- The full-frame height of the imaging sensor in pixels, as a uint32_t value.
- CAMERA_PHYSPROP_FOCALLENGTH35MM
- The 35mm-equivalent 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, 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.