Changelog

Changes in version 2.1.0 (from 2.0.0)

Trigger Delay

/**
    * @brief Query the currently configured trigger delay
    *
    * @return trigger delay in µs
    */
virtual float triggerDelay() const = 0;

/**
    * @brief set a new trigger delay [µs] for hardware trigger
    *
    * @param triggerDelay trigger delay in µs
    */
virtual void setTriggerDelay(float triggerDelay) = 0;

/**
    * @brief Query if trigger delay is available
    *
    * @return true if camera supports trigger delay setting, false otherwise
    */
virtual bool triggerDelayAvailable() const = 0;

/**
    * @brief get the camera's minimum / maximum trigger delay
    *
    * @return trigger delay range [µs]
    */
virtual vl::Range<float> triggerDelayLimits() const = 0;

Save & Load Camera Settings

It is now possible to save the currently configured camera setting (basically all API parameters) into a json config file. The software will handle the correct order of setting during load.

/**
    * @brief reset camera settings to defaults
    */
virtual void resetToDefaults() = 0;

/**
    * @brief load camera settings from file
    *
    * @param filepath path to the camera settings file
    */
virtual void loadSettings(const std::string &filepath) = 0;

/**
    * @brief write camera settings to file
    *
    * @param filepath path to the camera settings file
    */
virtual void saveSettings(const std::string &filepath) = 0;

Below is an example of the settings file. The exact contents are heavily dependent on the camera model and thus should be generated by save. It is possible to manually edit the file to create a different configuration.

{
    "version": "1",
    "datetime": "2024-11-14 08:52:29",
    "settings": {
        "exposure": "10001.0098",
        "exposureAutoMode": "Off",
        "exposureAutoMin": "12.6459999",
        "exposureAutoMax": "9999994",
        "gain": "0",
        "gainAutoMin": "0",
        "gainAutoMax": "0",
        "triggerMode": "Off",
        "flashOutputMode": "Off",
        "awbMode": "Off",
        "binningMode": "Off",
        "gamma": "1",
        "frameRate": "20.5899982"
    }
}

Other

Removed libhemistereo dependencies from public interface

The libhemistereo is another library created by 3dvisionlabs for image processing and 3D algorithms. We removed the remaining relicts from the libvl interface to make it more lightweight and reduce runtime dependencies.

Bugfixes

Acquisition Frame Rate Set in HW-Trigger Mode

We found some unexpected behavior in libvl, when the camera was operated in hardware-trigger mode: it was still possible to set a target framerate, which in turn led to issues during runtime. The setting now is locked for hardware-trigger mode as expected.