Changes between Version 20 and Version 21 of UnifiedCameraAccess


Ignore:
Timestamp:
Feb 25, 2011, 11:12:55 AM (14 years ago)
Author:
Matthias Vogelgesang
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • UnifiedCameraAccess

    v20 v21  
    99Properties of cameras are accessed in a vendor-neutral way by specifying the property names as defined in [http://ufo.kit.edu/ufo/browser/vogelgesang/uca/src/uca.h 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.
    1010
    11 ||= Property Name =||= Property String =||= Unit =||= Access =||= Meaning =||
    12 || `UCA_PROP_NAME`       || `name`       || C string || r || Name of camera ||
    13 || `UCA_PROP_WIDTH`      || `width`      || pixels   || r/w || Width of image to be taken ||
    14 || `UCA_PROP_WIDTH_MIN`  || `width.min`  || pixels   || r   || Minimum width of image to be taken ||
    15 || `UCA_PROP_WIDTH_MAX`  || `width.max`  || pixels   || r   || Maximum possible width ||
    16 || `UCA_PROP_HEIGHT`     || `height`     || pixels   || r/w || Height of image to be taken ||
    17 || `UCA_PROP_HEIGHT_MIN` || `height.min` || pixels   || r   || Minimum height of image to be taken ||
    18 || `UCA_PROP_HEIGHT_MAX` || `height.max` || pixels   || r   || Maximum possible height ||
    19 || `UCA_PROP_X_OFFSET`   || `offset.x`   || pixels   || r/w || Horizontal coordinate of start of ROI ||
    20 || `UCA_PROP_Y_OFFSET`   || `offset.y`   || pixels   || r/w || Vertical coordinate of start of ROI ||
    21 || `UCA_PROP_BITDEPTH`   || `bit-depth`  || bits     || r   || Bits per pixel ||
    22 || `UCA_PROP_EXPOSURE`     || `exposure`     || 10^-6^s    || r/w || Duration of image capture ||
    23 || `UCA_PROP_EXPOSURE_MIN` || `exposure.min` || 10^-6^s    || r   || Minimum duration of image capture ||
    24 || `UCA_PROP_EXPOSURE_MAX` || `exposure.max` || 10^-6^s    || r   || Maximum duration of image capture ||
    25 || `UCA_PROP_DELAY`        || `delay`        || 10^-6^s    || r/w || Delay before image capture ||
    26 || `UCA_PROP_DELAY_MIN`    || `delay.min`    || 10^-6^s    || r   || Minimum delay before image capture ||
    27 || `UCA_PROP_DELAY_MAX`    || `delay.min`    || 10^-6^s    || r   || Maximum delay before image capture ||
    28 || `UCA_PROP_TRIGGER_MODE` || `trigger-mode` || [#trigger see below] || r/w || Trigger mode for shutter opening ||
    29 || `UCA_PROP_FRAMERATE`    || `frame-rate`   || frames/s   || r   || Current number of frames per second ||
     11||= Property Name =||= Property String =||= Unit =||= Type =||= Access =||= Meaning =||
     12|| `UCA_PROP_NAME`       || `name`       || string   || C-String || r || Name of camera ||
     13|| `UCA_PROP_WIDTH`      || `width`      || pixels   || uint32_t || r/w || Width of image to be taken ||
     14|| `UCA_PROP_WIDTH_MIN`  || `width.min`  || pixels   || uint32_t || r   || Minimum width of image to be taken ||
     15|| `UCA_PROP_WIDTH_MAX`  || `width.max`  || pixels   || uint32_t || r   || Maximum possible width ||
     16|| `UCA_PROP_HEIGHT`     || `height`     || pixels   || uint32_t || r/w || Height of image to be taken ||
     17|| `UCA_PROP_HEIGHT_MIN` || `height.min` || pixels   || uint32_t || r   || Minimum height of image to be taken ||
     18|| `UCA_PROP_HEIGHT_MAX` || `height.max` || pixels   || uint32_t || r   || Maximum possible height ||
     19|| `UCA_PROP_X_OFFSET`   || `offset.x`   || pixels   || uint32_t || r/w || Horizontal coordinate of start of ROI ||
     20|| `UCA_PROP_Y_OFFSET`   || `offset.y`   || pixels   || uint32_t || r/w || Vertical coordinate of start of ROI ||
     21|| `UCA_PROP_BITDEPTH`   || `bit-depth`  || bits     || uint8_t  || r   || Bits per pixel ||
     22|| `UCA_PROP_EXPOSURE`     || `exposure`     || 10^-6^s    || uint32_t || r/w || Duration of image capture ||
     23|| `UCA_PROP_EXPOSURE_MIN` || `exposure.min` || 10^-6^s    || uint32_t || r   || Minimum duration of image capture ||
     24|| `UCA_PROP_EXPOSURE_MAX` || `exposure.max` || 10^-6^s    || uint32_t || r   || Maximum duration of image capture ||
     25|| `UCA_PROP_DELAY`        || `delay`        || 10^-6^s    || uint32_t || r/w || Delay before image capture ||
     26|| `UCA_PROP_DELAY_MIN`    || `delay.min`    || 10^-6^s    || uint32_t || r   || Minimum delay before image capture ||
     27|| `UCA_PROP_DELAY_MAX`    || `delay.min`    || 10^-6^s    || uint32_t || r   || Maximum delay before image capture ||
     28|| `UCA_PROP_TRIGGER_MODE` || `trigger-mode` || [#trigger see below] || uint8_t || r/w || Trigger mode for shutter opening ||
     29|| `UCA_PROP_FRAMERATE`    || `frame-rate`   || frames/s   || uint32_t || r   || Current number of frames per second ||
    3030
    3131The 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:
    3232
    33 ||= Property Name =||= Property String =||= Unit =||= Access =||= Meaning =||
    34 || `UCA_PROP_TIMESTAMP_MODE`         || `timestamp-mode`            || [#timestamp bitmask (see below)] || r/w || Print a timestamp ||
    35 || `UCA_PROP_SCAN_MODE`              || `scan-mode`                 || [#scanmode see below] || r/w || Enable certain scan modes ||
    36 || `UCA_PROP_INTERLACE_SAMPLE_RATE`  || `interlace.sample-rate`     || 1–2^16^ || r/w || Take only every `interlace-sample-rate` rows into account for the Fast-Reject algorithm ||
    37 || `UCA_PROP_INTERLACE_PIXEL_THRESH` || `interlace.threshold.pixel` || pixels  || r/w || Row is classified as triggered, when more than `interlace-row-threshold` pixels trigger ||
    38 || `UCA_PROP_INTERLACE_ROW_THRESH`   || `interlace.threshold.row`   || rows    || r/w || Ignore row trigger when less than `interlace-row-threshold` rows trigger ||
    39 || `UCA_PROP_CORRECTION_MODE`        || `correction-mode`           || [#correction bitmask (see below)] || r/w || Enable/disable certain correction modes ||
     33||= Property Name =||= Property String =||= Unit =||= Type =||= Access =||= Meaning =||
     34|| `UCA_PROP_TIMESTAMP_MODE`         || `timestamp-mode`            || [#timestamp bitmask (see below)] || uint8_t || r/w || Print a timestamp ||
     35|| `UCA_PROP_SCAN_MODE`              || `scan-mode`                 || [#scanmode see below] || uint8_t || r/w || Enable certain scan modes ||
     36|| `UCA_PROP_INTERLACE_SAMPLE_RATE`  || `interlace.sample-rate`     || 1–2^16^ || uint32_t || r/w || Take only every `interlace-sample-rate` rows into account for the Fast-Reject algorithm ||
     37|| `UCA_PROP_INTERLACE_PIXEL_THRESH` || `interlace.threshold.pixel` || pixels  || uint32_t || r/w || Row is classified as triggered, when more than `interlace-row-threshold` pixels trigger ||
     38|| `UCA_PROP_INTERLACE_ROW_THRESH`   || `interlace.threshold.row`   || rows    || uint32_t || r/w || Ignore row trigger when less than `interlace-row-threshold` rows trigger ||
     39|| `UCA_PROP_CORRECTION_MODE`        || `correction-mode`           || [#correction bitmask (see below)] || uint8_t || r/w || Enable/disable certain correction modes ||
    4040
    4141=== Values ===