Skip to content

CameraLowLightCompensation

property

Delphi
property CameraLowLightCompensation: Boolean read GetCameraLowLightCompensation write SetCameraLowLightCompensation default DEF_CameraLowLightCompensation;
C++Builder
__property bool CameraLowLightCompensation = {read=GetCameraLowLightCompensation, write=SetCameraLowLightCompensation, default=0};
C#
public bool CameraLowLightCompensation { get; set; }
VB.NET
Public Property CameraLowLightCompensation As Boolean
C++/Qt
BOOL GetCameraLowLightCompensation ();
void SetCameraLowLightCompensation (BOOL Value);

False (default): the Low Light Compensation of the video capture device is turned off while it is used (constant frame rate). True: the device setting is left as it is.

Remarks

By default (false), when a video capture device is opened for a preview or a recording, TVideoGrabber turns off its Low Light Compensation, also called auto exposure priority (the "Low Light Compensation" check box of the USB video device properties), if the device reports it: in low light the device keeps its frame rate, its auto exposure stays active within the frame period and the camera raises its gain instead, so the image can be darker or noisier. With the Low Light Compensation on, a camera in low light lengthens its exposure beyond the frame period and lowers its frame rate (e.g. from 30 to 20 fps), and some cameras skip frames while their exposure adapts during the first seconds.

The setting of the device is read when the preview or recording starts and restored when it stops (a change made meanwhile, e.g. in the device dialog, is undone); it is not restored if the application is terminated abnormally. Not done when QuickDeviceInitialization is enabled. Applies to the USB video class and other WDM devices only: DirectShow source filters (e.g. virtual cameras) are not changed.

Set to true before starting the preview or recording to leave the setting of the device as it is (it is not turned on), e.g. to favor a brighter image over the frame rate in low light.