AntiTearing
Top  Previous  Next

Description

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

Syntax


[VB]
objActiveGeni.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:

ActiveGeni1.AntiTearing = 
True

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