Integrate

Description

Enables/disables the frame integration operation and selects the integration mode. The frame integration allows you to average or add frames "on the fly" without sacrificing the frame rate. Used in combination with IntegrateWnd.

Syntax

[VB]
objActiveDcam.Integrate [= Value]

[C/C++]
HRESULT get_Integrate ( short *pIntegrate );
HRESULT put_Integrate( short Integrate );

Data Type [VB]

Integer


Parameters [C/C++]

pIntegrate [out,retval]

Pointer to the ordinal number of the currently selected Integrate filter, zero if Integrate conversion is disabled.

Integrate [in]

0 - Frame integration is disabled.

1 - Running Average mode. Each output frame is the result of averaging a selected number of previously captured frames.

2 - Running Accumulation mode. Each output frame is the sum of a selected number of previously captured frame.

Return Values

S_OK

Success

E_FAIL

Failure.

Example

This VB example activates the running average mode with a 16-frame window:

ActiveDcam1.IntegrateWnd=16
ActiveDcam1.Integrate = 1

Remarks

The frame integration is especially useful for suppressing the noise in the video and increasing its contrast in a low-light situation.