IID_IuEyeGain
This interface provides special features for setting the analog sensor gain for uEye models that are not covered by the standard DirectShow interface. The various gain channels for the sensor can each be set independently from 0 % to 100 %. The gain factor actually achieved at a setting of 100 % will depend on each sensor and is detailed in the section "Camera and Sensor Data" of the uEye Handbook.
|
Note on usage of sensor gain Amplifying signals will cause an increased level of image noise. For this reason it is not recommended to use a very high gain setting. It is recommended to use the following sequence when making your gain settings: 1.Enable the Gain_SetGainBoostValue feature (for additional analog gain) 2.Readjust where necessary using Gain_SetHwGainFactor Depending on when you have adjusted the gain, the change will be applied only to the next image you take. |
|
Note on the linearity of sensor gain On uEye cameras, you can set the gain factor in increments from 0 to 100. These increments are not graduated linearly throughout the range due to the sensor. The increments will typically be greater in the upper range than in the lower range. The maximum gain factor settings also vary from sensor to sensor. |
To use the interface, you must integrate the uEyeCaptureInterface.h header file into your project.
IuEyeGain provides the following features:
Returns whether the camera provides total gain master gain. |
|
Returns whether the camera provides RGB color gain. |
|
Returns the gain values set [0,100]. |
|
Sets the gain values [0,100]. |
|
Returns the default values for the gain. |
|
Returns the value range for the gain. |
|
Returns the set gain factors as percentages (e.g.: 200 corresponds to a factor of 2.0). |
|
Sets the gain factors as percentages. |
|
Returns the default values for the gain factors. |
|
Converts a normalized value [0,100] for the gain into a gain factor. |
|
Returns the value range for the gain factors. |
|
Returns whether the camera provides the analog Gain Boost feature. |
|
Returns whether the Gain Boost feature is enabled [0,1]. |
|
Sets the value of the Gain Boost [0,1]. |
