camera_physprop_t

Updated: April 19, 2023

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.