You are here: Technical Reference > Analog Control
FLIR

Firefly®

FFY-U3-16S2M-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.

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.
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. 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
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

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. 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

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-16S2M-DL
Camera Reference