Manual Exposure
When manual exposure is enabled the following parameters can be modified.
Exposure Time
The time in microseconds for an image exposure. Making it longer brightens the image (good for dark scenes) and making it shorter darkens the image. For moving scenes, shorter is better because there will be less motion blur in the image.
Gain
The gain setting brightens the image with a predetermined combination of electrical (analog) and mathematical (digital) gain. Increasing gain allows you to have a brighter image with the same exposure time, but increases the noise in the image.
Autoexposure
When autoexposure is enabled, the following parameters can be changed to modify the performance of the autoexposure algorithm
Maximum Exposure Time
Limits the exposure time to some value, and is useful when trying to limit motion blur in high speed situations.
Decay Rate
The autoexposure decay rage controls how many frames the camera takes to get the exposure right. In scenes where there are expected sudden flashes of light, it can be helpful to slow the autoexposure down
Intensity and Threshold
Autoexposure intensity and threshold parameters control the brightness of the image—what the autoexposure considers success. In a histogram of the image (where height is number of pixels and x-axis is brightness value) the autoexposure drives the exposure time until the threshold fraction of the pixels are below the intensity value. The camera defaults to intensity 0.5 and threshold 0.95, which means that the camera tries to make 95% of the pixels darker than 50% brightness. We do this to limit the number of pixels that become saturated in the image because saturated pixels have no information. Visually individuals tend to prefer images that have the threshold turned down below the default value of a bit, or that have the gamma Gamma turned up.
Region of Interest
A region of interest is defined four parameters (start_x, start_y, width, height) of a box in the unrectified image upon which the autoexposure operates. This is useful if a large portion of the image will contain the sky or will be blocked by the ego machine. The autoexposure will not use the data outside of the region of interest. Note that the region of interest horizontal values are on a range of 1-1920 and the vertical region of interest values are on a scale of 1-1200, even when the camera’s resolution is set to 960x600
Gamma
The gamma parameter sets the gamma correction of the image. It’s an exponential digital gain that applies more gain to darker pixels and less gain to brighter pixels. If there are dark parts of the scene that you’d like to brighten without saturating bright parts of the scene, you can increase this. If you’d like the image to be more linear, decrease this.
Frame Rate
Frame rate is the number of frames per second the camera outputs. There is something important to understand here: this is the output frame rate. The frame rate upon which the autoexposure operates is a whole number multiple of this frame rate near 30FPS. For example, if you set the frame rate to 9 FPS, the autoexposure will be correcting the image sensor at a rate of 27FPS. If you set the frame rate to 19 FPS, the autoexposure will operate at 19FPS.
Stereo Post-Filter
The stereo post-filter configuration filters the disparity image according to matching cost. A high Stereo Post Filter gives high confidence disparity images with very low density. A low stereo post filter gives a very high density disparity image with low accuracy and low confidence.
Resolution
Resolution is parametrized by the triplet of (Width x Height x Disparities). The first number is the image width, the next number is the image height, and the last number is the maximum number of disparity levels. The disparity levels parameter affects the tradeoff between how far the camera can see and how fast the algorithm can run. Since we’ve done a bunch of work on increasing frame rates and for other reasons are limited to 30FPS, lots of these have a limit of 30FPS. The options are:
Resolution |
Max FPS |
---|---|
1920 x 1200 x 256 |
9 FPS |
1920 x 1200 x 128 |
15 FPS |
1920 x 1200 x 64 |
15 FPS |
960 x 600 x 256 |
30 FPS |
960 x 600 x 128 |
30 FPS |
960 x 600 x 64 |
30 FPS |