CamParams

Current camera and lens parameters provided by d3cam apps

Notes on Focus / lensPos from iOS docs (Peter added notes in []brackets): “A given lens position value does not correspond to an exact physical distance, nor does it represent a consistent focus distance from device to device[, or even over time, … due to influence of wear, gravity, temperature, hysteresis, …]. The range of possible positions is 0.0 to 1.0, with 0.0 being the shortest distance at which the lens can focus and 1.0 the furthest. Note that 1.0 does not represent focus at infinity. The default value is 1.0. [Infinity distance could be around 0.9 or even lower. Hysteresis effect is up to ±0.02. Devices might report lensPos differences of at least ±0.07 for the same distance.]”. See investigation in: d3vision\optical-calibration\iPod focus investigation.ods

Notes on ISO and exposure: The min/max available for ISO and exposure time/bias is device-dependent. Higher ISO means more light sensitivity, but also noise.

Notes on White-Balance: Main parameter is the CIE 1931 xy Chromaticity, a 2D coordinate between 0 and 1 that specifies a colour in the CIE colourspace. This is a device-independent parameter equivalent to the 3 gain values for RGB, which are device-dependent, though. The values for RGB channel gains are between 1 and a device-specific maximum value.

Notes on Aperture and Field-of-View: On current iOS devices the aperture (F-stop) is fixed. Since there is no optical zoom, the Field-of-View only changes if digital zoom is enabled (I think). The FOV is a nominal value, not taking the (minor but noticeable) effect of focus into account. Similarly, for machine vision cameras

NOTE: Serialised using versioned cereal functions (no longer affects ExpectedAppVersion!)

Base class: _BlipValue

Properties

aperture : float (Read-Only)

camParamMode : int (Read-Only)

exposureBias : float (Read-Only)

exposureDur : float (Read-Only)

exposureMode : int (Read-Only)

exposureTarget : float (Read-Only)

fieldOfViewNominal : float (Read-Only)

focalLength : float (Read-Only)

focusMode : int (Read-Only)

isAdjustingExposure : bool (Read-Only)

isAdjustingFocus : bool (Read-Only)

isAdjustingWB : bool (Read-Only)

iso : float (Read-Only)

lensPos : float (Read-Only)

lensPosComp : int (Read-Only)

poi : Vec2 (Read-Only)

resolution : Int2 (Read-Only)

wbChroma : Vec2 (Read-Only)

wbMode : int (Read-Only)

wbRgbGains : Vec (Read-Only)

zoom : float (Read-Only)