AntiTearing

Description

Enables/disables the anti-tearing feature for the live video display in the control window.

Syntax

[VB]
objActiveGige.AntiTearing [= Value]

[C/C++]
HRESULT get_AntiTearing ( bool *pValue );
HRESULT put_AntiTearing( bool Value );


Data Type [VB]

Boolean


Parameters [C/C++]

pValue [out,retval]

Pointer to the Boolean that is TRUE if the anti-tearing is enable, or FALSE otherwise

Value [in]

Set to TRUE to enable the anti-tearing, or set to FALSE to disable it

Return Values

S_OK

Success

E_FAIL

Failure.

Example

This VB example enables the anti-tearing feature:

ActiveGige1.AntiTearing = True
MsgBox ActiveGige1.AntiTearing

Remarks

Tearing is a display artifact caused by the difference between the frame rate of the camera and the refresh rate of the monitor. Tearing can be noticed on the live video as horizontal splits between the upper and bottom parts of frames with highly dynamic contest. If AntiTearing is set to TRUE, the display update will be synchronized with the vertical blank period of the monitor thus eliminating tearing artifacts.

When AntiTearing is enable, the effective frame rate will be limited by the monitor's refresh rate. You can also experience a performance drop resulting in an additional CPU load.

Note - some advanced graphic controllers may have the anti-tearing functionality implemented in the hardware. If your system have such a graphic card, do not enable the AntiTearing property.