Motion detection
Motion detection.
Description
Motion detection overview
The motion detection is enabled when MotionDetector_Enabled is true. The frame grabber must be enabled to use this feature.
When motion detection is enabled, TVideoGrabber compares the last video frame received to the previous one, unless a reference sample has been specified with MotionDetector_UseThisReferenceSample
For each video frame, if motion is detected, the OnMotionDetected event occurs, that returns a global motion ratio, depending of the number of cells in which motion has been detected, and the level of motion in each cell.
If no no motion is detected, the OnMotionNotDetected event occurs.
Areas in which motion can be detected
To let you limit the areas of the video frames in which motion will be detected, the video frame is divided in a grid composed of lines and rows, that defines cell having a motion level.
In each cell, the motion level can be set in a range from 1 (minimal motion sensitivity) to 9 (maximal motion sensitivity).
A value of 0 disables motion detection in the cell.
This is explained in the Grid structure / grid sensitivity chapter.
Triggered motion detection
By default, the motion detection occurs for each video frame.
If you want to trigger the motion detection manually, enable the MotionDetector_Triggered property.
Then, invoke MotionDetector_TriggerNow during preview, recording or playback to trigger the motion detection one time, until the next MotionDetector_TriggerNow call.
Detection of the video signal
Is it possible to detect if the video signal is present or not for each video frame, by invoking IsVideoSignalDetected.
See Also
Color / Greyscale Grid structure / grid sensitivity Motion ratio Recording only when motion is detected Video noise TOnMotionDetected TOnMotionNotDetected MotionDetector_CellMotionRatio MotionDetector_CompareBlue MotionDetector_CompareGreen MotionDetector_CompareRed MotionDetector_Enabled MotionDetector_EnumGridDialogControls MotionDetector_Get2DTextGrid MotionDetector_Get2DTextMotion MotionDetector_GetCellLocation MotionDetector_GetCellSensitivity MotionDetector_GetCellSize MotionDetector_GloballyIncOrDecSensitivity MotionDetector_GlobalMotionRatio MotionDetector_GreyScale MotionDetector_Grid MotionDetector_GridXCount MotionDetector_GridYCount MotionDetector_IsGridValid MotionDetector_MaxDetectionsPerSecond MotionDetector_ReduceCPULoad MotionDetector_ReduceVideoNoise MotionDetector_Reset MotionDetector_ResetGlobalSensitivity MotionDetector_SetCellSensitivity MotionDetector_SetGridSize MotionDetector_ShowGridDialog MotionDetector_Triggered MotionDetector_UseThisReferenceSample OnBacktimedFramesCountReached OnMotionDetected OnMotionNotDetected RecordingOnMotion_Enabled RecordingOnMotion_MotionThreshold RecordingOnMotion_NoMotionPauseDelayMs