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)