You are here: Technical Reference > Analog Control
FLIR

Firefly®

FFY-U3-16S2C-DL

 

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.

The white balance can also be modified by selecting a light source with RGB Transform Light Source. Selecting a light source modifies both the red and blue balance ratio values as well as the active RGBtoRGB Color Transformation, to acheive good color for the specified lighting condition.

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.

Sharpening

The sharpening features control how sharp the image looks.

Sharpening can be enabled (On) or disabled (Off). By default sharpening is disabled. Use Sharpening Enable to switch on or off.

When sharpening is enabled, the remaining sharpening features take effect. When it is disabled, the image is not sharpened.

Adjust the sharpening amount with the Sharpening control. This value controls how much to amplify the unsharp mask applied to the image.

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 [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 IFloat RW Beginner Controls the amount to sharpen a signal. The sharpened amount is proportional to the difference between a pixel and its neighbors.
Denoise Enable IBoolean Beginner Enables/disables the denoise feature. Denoising is disabled by default.
Denoising IInteger Beginner Controls the amount to denoise a signal.

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

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

Controls the amount to sharpen a signal. The sharpened amount is proportional to the difference between a pixel and its neighbors.

Property Value
Name Sharpening
Interface IFloat
Access RW
Unit %
Visibility Beginner

Denoise Enable

Enables/disables the denoise feature. Denoising is disabled by default.

Property Value
Name DenoiseEnable
Interface IBoolean
Access
Visibility Beginner

Denoising

Controls the amount to denoise a signal.

Property Value
Name Denoise
Interface IInteger
Access
Unit %
Visibility Beginner

 

5/8/2020
© 2015-2020 FLIR® Integrated Imaging Solutions Inc.
All rights reserved.
Legal
| Contact Support

Firefly® FFY-U3-16S2C-DL
Camera Reference