Changes between Version 3 and Version 4 of UnifiedCameraAccess

Timestamp:

Feb 24, 2011, 8:15:23 AM (14 years ago)

Author:

Matthias Vogelgesang

Comment:

--

UnifiedCameraAccess

@@ -5 +5 @@
 == Specification ==
 
-Properties of cameras are accessed in a vendor-neutral way by specifying the property names as defined in `uca.h`. The following list is the definite specification of basic properties that all devices must implement:
+Properties of cameras are accessed in a vendor-neutral way by specifying the property names as defined in `uca.h`. The following list is the definite specification of basic properties that all devices must implement. If a property cannot be set or get via `uca_(get|set)_property()` the function shall return UCA_ERR_PROP_INVALID.
 
 ||= Property Name =||= Property String =||= Unit =||= Access =||= Meaning =||
@@ -19 +19 @@
 || UCA_PROP_DELAY      || `delay`      || microseconds   || r/w || Delay before image capture ||
 || UCA_PROP_FRAMERATE  || `frame-rate` || frames per second || r || Current number of frames per second ||
+|| UCA_PROP_TRIGGERMODE || `trigger-mode` || see below || r/w || Trigger mode for shutter opening ||
+
+The following table lists special properties that are ignored (and also flagged with an `UCA_ERR_PROP_INVALID` return value) by cameras that don't support them:
+
+||= Property Name =||= Property String =||= Unit =||= Access =||= Meaning =||
+|| UCA_PROP_INTERLACE_SAMPLE_RATE  || `interlace-sample-rate`     || integer quantity || r/w || Take only every `interlace-sample-rate` rows into account for the Fast-Reject algorithm ||
+|| UCA_PROP_INTERLACE_PIXEL_THRESH || `interlace-pixel-threshold` || number of pixels || r/w || Row is classified as triggered, when more than `interlace-row-threshold` pixels trigger ||
+|| UCA_PROP_INTERLACE_ROW_THRESH   || `interlace-row-threshold`   || number of rows   || r/w || Ignore row trigger when less than `interlace-row-threshold` rows trigger ||
+
+A camera may use different trigger signals to start exposure. Possible values are:
+
+||= Trigger Name =||= Meaning =||
+|| UCA_TRIGGER_AUTO || Free run mode ||
+|| UCA_TRIGGER_EXTERNAL || Trigger via external hardware ||