The MontiVision Motion Detection filter detects motion within one or more predefined regions of the input video stream. The sensitivity of the motion detection algorithm is adjustable.
| File: | MotionDetection.ax |
| CLSID: | CLSID_MVMotionDetection |
Interface
Supported COM Events
The filter supports following events through the IMVFilterEvents interface. Look at the filter events page for more information.
| Event |
Value |
Description |
| MV_ALGORITHM_START_EVENT |
0 |
A filter starts processing a video frame or sample. |
| MV_ALGORITHM_END_EVENT |
1 |
A filter finishes processing a video frame or sample. |
| MV_MOTION_START_EVENT |
17 |
The filter recognized motion within the video. |
| MV_MOTION_END_EVENT |
18 |
The filter recognized that the motion within the video ended. |
| MV_RECORD_START_EVENT |
19 |
The filter set the boolean record I/O output pin to TRUE. |
| MV_RECORD_END_EVENT |
20 |
The filter set the boolean record I/O output pin to FALSE. |
Supported I/O Pins
| I/O Pin | Corresponding method | Discription |
| Motion
Out [Boolean] |
- | Set to TRUE while motion is detected and FALSE otherwise. |
| Record Out [Boolean] |
- | Set to TRUE while motion is detected and stays TRUE until the number of defined post roll frames are processed. This pin is perfectly used to control the MV Recording filter. |
Attention:
I/O Pins are dominant, that means that they have a higher
priority than the corresponding method of the filters
interface!
MV Motion Detection Property Pages
Uses the IMVMotionDetection configuration interface.
| Enable motion detection | Enables or disables motion detection. |
| Visualize areas showing motion | Specifies whether areas wherein motion is detected are highlighted. |
| Colour | The colour that is used to highlight motion areas. |
| Minimum pixel luminance difference | Motion is signaled for a single pixel if the luminance change of the pixel between the last and the current video frame is higher than this value. |
| Minimum number of changed pixels in percent | Motion is signaled for a specified region if the number of pixels that are signaled is higher than this value. |
| Number of post roll frames | After the state of a region returned to nonsignaled, a defined number of post roll frames will additionally be send. |
| Number of used regions | Number of different regions that are set up for motion detection. |
| Currently selected region | Currently selected region. This region can be modified using the controls within the Origin and Dimension group boxes. |
| Origin and Dimension | Used to adjust the size and the origin of the currently selected region. |
| Draw region | Specifies whether the rectangles of the motion detection regions are drawn onto the video stream. |