camera_physprop_t

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.

Page updated: March 12, 2026