Analog Control

Gain

Gain is the amount of amplification that is applied to a pixel by the A/D converter. An increase in gain can result in a brighter image but also an increase in noise.

Gain can be manually or automatically controlled.

Use the Gain Selector to choose which gain to control. The All selection is a total amplification across all channels (or taps).

For manual control, set GainAuto to Off. Use the Gain control to set the amplification in dB.

For automatic control, set GainAuto to Once or Continuous. The camera automatically adjusts the gain to maximize the dynamic range. Once briefly enables automatic gain to adapt the device and then sets gain back to manual control (Off). Continuous constantly adapts the device.

Note: For the Auto Exposure feature, gain and/or exposure time must be set to Once or Continuous.

Black Level

The Black Level feature controls the offset applied to the video signal. It determines the image average when there is no light reaching the sensor.

There are two methods of applying black level: Analog and Digital. The analog black level controls the offset applied during analog-to-digital (A/D) conversion. The digital black level is an offset applied after the image has been digitized.

The sum of the analog and digital black levels can be set and read by setting Black Level Selector to All and then using the Black Level feature to enter or view the percentage offset.

Only the total black level (All) can be set by the user. Based on the value of black level All, the analog and digital black levels are automatically set to achieve the requested total black level.

White Balance - Color Models

White balance compensates for color shifts caused by different lighting conditions. White balance is specified as the gains of the Red and Blue channels relative to Green. For example, if the blue balance ratio is set to 1.5 then 50% more gain is applied to the blue channel than the green channel. White balance can be manually or automatically controlled.

For manual control, set White Balance Auto to Off. Use the Balance Ratio Selector to select either the Red or Blue channel. Use the Balance Ratio to specify a value for that channel. To disable white balance, set both red and blue balance ratios to 1.0.

For automatic control, set White Balance Auto to Once or Continuous. The camera automatically adjusts the red and blue balance ratios to achieve good color balance. Once runs for a number of iterations and then sets White Balance Auto to Off. Continuous adjusts the values continually if the algorithm determines that the colors are imbalanced. A number of parameters that affect automatic white balance are available in the AutoAlgorithmControl category.

Gamma

The Gamma feature controls the gamma correction applied to pixel intensity. The equation used is:

where P is the input pixel value and P' is the pixel value after gamma correction. Note that the value for Gamma is defined as the power applied to the pixel value, and not the gamma of the display. If a display with a gamma of 2.0 is used, the image gamma can be set to 0.5 to compensate. For sRGB output, Gamma should be set to 0.4545 (1/2.2).

If linear output data is required, disable gamma by setting GammaEnable to 0.

Gamma and the Pixel Lookup Table (LUT) can both be used at once. Gamma is applied before the Pixel LUT.

Summary Table

Name Interface Access Visibility Description
Gain Selector IEnumeration Beginner Selects which gain to control. The All selection is a total amplification across all channels (or taps).
Gain [Gain Selector] IFloat Beginner Controls the amplification of the video signal in dB.
Gain Auto IEnumeration Beginner Sets the automatic gain mode. Set to Off for manual control. Set to Once for a single automatic adjustment then return to Off. Set to Continuous for constant adjustment. In automatic modes, the camera adjusts the gain to maximize the dynamic range.
Black Level Selector IEnumeration Beginner Selects which black level to control. Only All can be set by the user. Analog and Digital are read-only.
Black Level Raw [Black Level Selector] IInteger Expert Controls the offset of the video signal in camera specific units.
Black Level [Black Level Selector] IFloat Beginner Controls the offset of the video signal in percent.
Black Level Clamping Enable IBoolean RW Guru Enable the black level auto clamping feature which performs dark current compensation. This feature is not supported by rolling shutter sensors.
Balance Ratio Selector IEnumeration Expert Selects a balance ratio to configure once a balance ratio control has been selected.
Balance Ratio [Balance Ratio Selector] IFloat Expert Controls the balance ratio of the selected color relative to green. Used for white balancing.
Balance White Auto IEnumeration RW Expert White Balance compensates for color shifts caused by different lighting conditions. It can be automatically or manually controlled. For manual control, set to Off. For automatic control, set to Once or Continuous.
Gamma IFloat Beginner Controls the gamma correction of pixel intensity.
Gamma Enable IBoolean Beginner Enables/disables gamma correction.
Sharpening Enable IBoolean RW Beginner Enables/disables the sharpening feature. Sharpening is disabled by default.
Sharpening Auto IBoolean RW Beginner Enables/disables the auto sharpening feature. When enabled, the camera automatically determines the sharpening threshold based on the noise level of the camera.
Sharpening IFloat RW Beginner Controls the amount to sharpen a signal. The sharpened amount is proportional to the difference between a pixel and its neighbors. A negative value smooths out the difference, while a positive value amplifies the difference. You can boost by a maximum of 8x, but smoothing is limited to 1x (in float). Default value: 2.0
Sharpening Threshold IFloat RW Guru Controls the minimum intensity gradient change to invoke sharpening. When "Sharpening Auto" is enabled, this is determined automatically by the device. The threshold is specified as a fraction of the total intensity range, and ranges from 0 to 0.25. A threshold higher than 25% produces little to no difference than 25%. High thresholds sharpen only areas with significant intensity changes. Low thresholds sharpen more areas.

Analog Control Features


Gain Selector

Selects which gain to control. The All selection is a total amplification across all channels (or taps).

Property Value
Name GainSelector
Interface IEnumeration
Access
Visibility Beginner

Enumeration Values
All

Gain

Controls the amplification of the video signal in dB.

Property Value
Name Gain [Gain Selector]
Interface IFloat
Access
Unit dB
Visibility Beginner

Gain Auto

Sets the automatic gain mode. Set to Off for manual control. Set to Once for a single automatic adjustment then return to Off. Set to Continuous for constant adjustment. In automatic modes, the camera adjusts the gain to maximize the dynamic range.

Property Value
Name GainAuto
Interface IEnumeration
Access
Visibility Beginner

Enumeration Values
Off
Once
Continuous

Black Level Selector

Selects which black level to control. Only All can be set by the user. Analog and Digital are read-only.

Property Value
Name BlackLevelSelector
Interface IEnumeration
Access
Visibility Beginner

Enumeration Values
All
Analog
Digital

Black Level Raw

Controls the offset of the video signal in camera specific units.

Property Value
Name BlackLevelRaw [Black Level Selector]
Interface IInteger
Access
Unit
Visibility Expert

Black Level

Controls the offset of the video signal in percent.

Property Value
Name BlackLevel [Black Level Selector]
Interface IFloat
Access
Unit %
Visibility Beginner

Black Level Clamping Enable

Enable the black level auto clamping feature which performs dark current compensation. This feature is not supported by rolling shutter sensors.

Property Value
Name BlackLevelClampingEnable
Interface IBoolean
Access RW
Visibility Guru

Balance Ratio Selector

Selects a balance ratio to configure once a balance ratio control has been selected.

Property Value
Name BalanceRatioSelector
Interface IEnumeration
Access
Visibility Expert

Enumeration Values
Red
Blue

Balance Ratio

Controls the balance ratio of the selected color relative to green. Used for white balancing.

Property Value
Name BalanceRatio [Balance Ratio Selector]
Interface IFloat
Access
Unit
Visibility Expert

Balance White Auto

White Balance compensates for color shifts caused by different lighting conditions. It can be automatically or manually controlled. For manual control, set to Off. For automatic control, set to Once or Continuous.

Property Value
Name BalanceWhiteAuto
Interface IEnumeration
Access RW
Visibility Expert

Enumeration Values
Off
Once
Continuous

Gamma

Controls the gamma correction of pixel intensity.

Property Value
Name Gamma
Interface IFloat
Access
Unit
Visibility Beginner

Gamma Enable

Enables/disables gamma correction.

Property Value
Name GammaEnable
Interface IBoolean
Access
Visibility Beginner

Sharpening Enable

Enables/disables the sharpening feature. Sharpening is disabled by default.

Property Value
Name SharpeningEnable
Interface IBoolean
Access RW
Visibility Beginner

Sharpening Auto

Enables/disables the auto sharpening feature. When enabled, the camera automatically determines the sharpening threshold based on the noise level of the camera.

Property Value
Name SharpeningAuto
Interface IBoolean
Access RW
Visibility Beginner

Sharpening

Controls the amount to sharpen a signal. The sharpened amount is proportional to the difference between a pixel and its neighbors. A negative value smooths out the difference, while a positive value amplifies the difference. You can boost by a maximum of 8x, but smoothing is limited to 1x (in float). Default value: 2.0

Property Value
Name Sharpening
Interface IFloat
Access RW
Unit
Visibility Beginner

Sharpening Threshold

Controls the minimum intensity gradient change to invoke sharpening. When "Sharpening Auto" is enabled, this is determined automatically by the device. The threshold is specified as a fraction of the total intensity range, and ranges from 0 to 0.25. A threshold higher than 25% produces little to no difference than 25%. High thresholds sharpen only areas with significant intensity changes. Low thresholds sharpen more areas.

Property Value
Name SharpeningThreshold
Interface IFloat
Access RW
Unit
Visibility Guru