L515 - Add digital gain option that replace ambient light option by Nir-Az · Pull Request #7563 · realsenseai/librealsense

Nir-Az · 2020-10-13T18:03:52Z

Original Requirement : "Rename ambient light option to digital gain"

Add digital gain option at same option value as ambient light
Add comment on LRS API option ambient light that it is deprecates
Replace ambient light option registration with digital gain option (same value for both) from L515 depth sensor
Add it to all wrappers
Add special case for python wrapper for dealing with 2 options with the same value
no ambient == high gain

Tested on:

RealSense Viewer
Python wrapper
C# wrapper

Tracked on [RS5-9152]

maloel · 2020-10-18T05:21:48Z

-                { float(RS2_AMBIENT_LIGHT_LOW_AMBIENT), "Low Ambient" }}));
+            (RS2_OPTION_VISUAL_PRESET, std::make_shared<uvc_xu_option<int >>(raw_depth_sensor, ivcam2::depth_xu, ivcam2::L500_DIGITAL_GAIN,
+                "Change the depth digital gain to: 1 for high gain and 2 for low gain",
+                std::map<float, std::string>{ { float(RS2_DIGITAL_GAIN_HIGH_GAIN), "High Gain"},


Interesting... it doesn't take the string representation from the get_string() functions?

It was implemented this way with ambient light so I kept it.
If I remove the map the viewer will display it as a slider (we don't want it), the strings map makes the viewer display it as a combo box.

maloel · 2020-10-18T05:23:10Z

-                    { RS2_AMBIENT_LIGHT_LOW_AMBIENT, "Low Ambient" }});
+            _digital_gain = register_option<uvc_xu_option<int>, uvc_sensor&, platform::extension_unit, uint8_t, std::string, const std::map<float, std::string>& >
+                (RS2_OPTION_DIGITAL_GAIN, raw_depth_sensor, ivcam2::depth_xu, ivcam2::L500_DIGITAL_GAIN,
+                    "Change the depth digital gain to values: 1 for high gain and 2 for low gain",


to values: -> to:

maloel · 2020-10-18T05:26:05Z

 const char* rs2_calibration_type_to_string(rs2_calibration_type type)                     { return get_string(type); }
 const char* rs2_calibration_status_to_string(rs2_calibration_status status)               { return get_string(status); }
 const char* rs2_host_perf_mode_to_string(rs2_host_perf_mode mode)                         { return get_string(mode); }
+const char* rs2_digital_gain_to_string(rs2_digital_gain gain)                             { return get_string(gain); }


Can we move this to right after the rs2_ambient_light?

maloel · 2020-10-18T05:27:27Z

    RS2_ENUM_HELPERS_CUSTOMIZED(rs2_ambient_light, RS2_AMBIENT_LIGHT_NO_AMBIENT, RS2_AMBIENT_LIGHT_LOW_AMBIENT)
    RS2_ENUM_HELPERS(rs2_cah_trigger, CAH_TRIGGER)
    RS2_ENUM_HELPERS(rs2_host_perf_mode, HOST_PERF)
+    RS2_ENUM_HELPERS_CUSTOMIZED(rs2_digital_gain, RS2_DIGITAL_GAIN_HIGH_GAIN, RS2_DIGITAL_GAIN_LOW_GAIN)


Move right after rs2_ambient_light