Table of Contents   MOBOTIX Online Help

Video Motion Detection

The video motion sensor reacts to movements in certain image areas called video motion windows (VM windows in short). You can define one or more independent video motion windows for each image sensor (camera image).

Next, you can create different image analysis events, which only react to subsets of these windows. This provides a means for filtering according to direction of motion, for example (see the Event Logic help page).

Visualization of Video Motion Windows

If Video Motion Style has been set to On and highlight on event, for example, the camera will display every VM window as a dotted frame.

VM Window Elements

1

Frame:

  • White: Standard VM windows.
  • Yellow: Reference windows.
  • Red: VM window has triggered.

2

VM window ID:
Number of the VM window in the definition box.

3

Minimum area trigger:
triggers an event (alarm) if the changes in the image exceed the percentage set in the minimum area parameter (see Video Motion Window Definitions below).

4

Status bar:

  • Hidden: VM window is not active (too dark or initializing).

Frame: If the camera detects movements in an active VM window that exceed the percentage set in the minimum area parameter (and is below maximum area, see Video Motion Window Definitions below), the complete frame of the window turns red.

VM window ID: If Show Video Motion Window ID has been enabled (this is the default), every window shows an identification number in its top left corner. This number can be set in the window definition (q.v.). IDs for windows with no explicit or erroneous definitions are automatically assigned in the order of their definitions.

Status bar: Shows the current activity (detected movement in the image) of every window and has one or two small markers showing the current trigger limits (see Video Motion Window Definitions below). If the VM window is not active (too dark or initializing), camera will hide the status bar for this time.

Video Motion Window Definitions

Every line in the definition box that does not begin with a dollar ($generate=, auto-generated VM windows or variables) or hash sign (#, comments) defines one VM window.

Video motion windows can be defined either as rectangles or as polygons.

Rectangle syntax:
[!]image sensor, horizontal position, vertical position, width, height [, a=<min. area>] [, am=<max. area>] [, s=<sensitivity>] [, col=<color>] [, id=<ID number>]
(optional parameters have brackets)

Example: 0,270,190,100,100,a=25,am=90,s=15,col=blue,id=5

Polygon syntax:
[!]image sensor, poly=<hor. coordinate>x<vert. coordinate>{/<hor. coordinate>x<vert. coordinate>}[, a=<min. area>] [, am=<max. area>] [, s=<sensitivity>] [, col=<color>] [, id=<ID number>]
(optional parameters have square brackets, parameters that can be used as often as needed have curly brackets)

Example: 0,poly=270x190/270x289/369x289/369x190,a=25,am=90,s=15,col=blue,id=5

Notes:

Parameter Description
! Defines a reference window (see below).
Image Sensor Selects the image sensor (camera image) to use for this video motion definition:
  • 0: Right camera image on dual cameras, default setting on mono cameras.
  • 1: Left camera image on dual cameras.
Horizontal position Position of the left window border measured from the left edge of the visible image in pixels (based on a MEGA image 1280x960).
Vertical position Position of the lower window border measured from the lower edge of the visible image in pixels (based on a MEGA image 1280x960).
Width Width of the window in pixels (based on a MEGA image 1280x960).
Height Height of the window in pixels (based on a MEGA image 1280x960).
Horizontal Coordinate Position of the left exposure window border measured horizontally from the left edge of the visible image to the polygon corner in pixels (based on a MEGA image 1280x960).
Vertical Coordinate Position of the left exposure window border measured vertically from the bottom edge of the visible image to the polygon corner in pixels (based on a MEGA image 1280x960).
Minimum area Values: 0-99 (lower: more sensitive)
This parameter controls the percentage of the VM window area that needs to change from one frame to the next in order to trigger an event. Decreasing this value will make the VM window more sensitive. This value can be left out; in this case, the camera will use the default value of 25.
Maximum area Values: 0-99
The maximum percentage of the window area that is allowed to change from one frame to the next in order to trigger an event. You can use this value to suppress false alarms resulting from global changes (e.g. when the lights are turned on). This is an optional parameter, which will not be used, if it has not been specified explicitly.

Sensitivity Values: 0-99 (higher: less sensitive)
This parameter controls the percentage of detected change in the pixels in a VM window, which must be reached to trigger an event. Besides the detection area, this is the second parameter to tune the detection performance. The sensitivity value can normally be left out (thus using the default setting), but may be helpful in difficult situations. By default, this value is 20 for regular VM windows and 10 for reference windows.

Color Values: black, red, green, blue, cyan, magenta, dred, dgreen, dblue
This parameter sets the background color of window frame and status line. A missing or erroneous specification will result in black being chosen.

ID-number Values: 1-999
This parameter sets the ID-number of the window. If an invalid number is specified, or it has been previously assigned, the window reverts to automatic enumeration.

Note: If you would like to define a new or additional window, open the Event Settings dialog and follow the instructions in the Graphically Entering Image Areas help page.

Using reference windows to avoid false alarms

Reference windows are used to avoid false alarms for events that would be triggered by VM windows, e.g. if lighting conditions change rapidly (sun and cloudy sky, headlights from cars, etc.).

To define a reference window, simply create an additional VM window in a portion of the image where no movements are expected. Then add an exclamation mark (!) in front of the VM window definition.

Example: !0,912,750,364,188,a=25

Note that specifying a maximum area for reference windows is possible, but not very useful.

If a reference window triggers, all events using it will be disabled for the time specified for the Video Motion Suppression Time parameter. If this value is 0, the camera only suppresses triggers at the same moment as the reference window.

Using Comments to Deactivate Window Definitions

In order to temporarily deactivate VM windows, place a hash sign (#) in front of the definition. This VM window definition will still be saved, but will not be used as a video motion window. In addition, comments generally help keep an overview if the VM window definitions are complex.

Auto-Generated VM Windows

This special mode allows generating several video motion windows with only one line, allowing you to create a "minefield" of VM windows with only one definition line. It can also be used to quickly find an optimum set of parameters for a given lighting situation. This is an example for a auto-generated VM window definition line with all optional parameters:

Example: $generate=0,100,100,20,20,25,25,70,70

Syntax:
$generate=image sensor, width, height, horizontal gap, vertical gap, min. area left, min. area right, max. area bottom, max. area top
None of the parameters are mandatory (the most simple definition is $generate=); if no values are specified, the camera will use the defaults.

Parameter Description
Image Sensor Selects the image sensor (camera image) to use for this video motion definition:
  • 0: Right camera image on dual cameras, default setting on mono cameras.
  • 1: Left camera image on dual cameras.
Width Width of the VM window in pixels.
Default: 100
Height Height of the VM window in pixels.
Default: 100
Horizontal gap Horizontal distance between one window and the next in pixels.
Default: 20
Vertical gap Vertical distance between one window and the next in pixels.
Default: 20
Minimum area If two different values are specified, the minimum area parameter for the generated windows varies between the first value for the leftmost column of windows and the second value for the rightmost column. The values for the windows in-between are interpolated linearly. If the same value is specified for both parameters, all windows use this value.
Default: 25
Maximum area Varies the maximum area parameter in the same fashion as for minimum area, but in vertical direction from bottom to top. If no values are specified, the maximum area is disabled.
Default: Off

Generated windows have their own ID numbering system, indicated by a leading "g".

Make sure that you only use the maximum area parameter if absolutely necessary. It can help when trying to determine a good value for this kind of "minefield" set of VM window definitions.

Variables

Certain situations may require further fine-tuning of the behavior of the video motion windows using the following variables. Note that you do not need to change the default settings unless you need to handle very special situations.

Copy Window Definitions

If this option is activated, all video motion definitions will be used on both image sensors. This option is only available on Day/Night models.

Dual Lens Video Motion

Activating this option will detect video motion on both image sensors (regardless of which sensor is actually shown on the Live screen). Note that using this option may reduce the maximum frame rate. A video motion window explicitly defined for the left image sensor will remain active, even if you only see the image of the camera's right image sensor. This means that the camera will react on events detected on the left (invisible) image sensor. This option is only available on Dual models.

Low-Light Suppression

Disables motion detection if illumination drops below the selected value. This value can be set independently for each camera lens.

Video Motion Suppression Time

If a positive value is entered, a triggering reference window suppresses motion detection for this duration.

Hide Unused Windows

With this option, windows that are not used in an active event are not processed and not visualized in the image. Using this function, a subset of windows can be selected from an automatically generated field. The unused windows do not use any processing time or clutter the image.


Storing the Configuration

Click on the Set button to activate your settings and to save them until the next reboot of the camera.

Click on the Factory button to load the factory defaults for this dialog (this button may not be present in all dialogs).

Click on the Restore button to undo your most recent changes that have not been stored in the camera permanently.

Click on the Close button to close the dialog. While closing the dialog, the system checks the entire configuration for changes. If changes are detected, you will be asked if you would like to store the entire configuration permanently.

cn, de, en, es, fr, it, jp, ru

© 2001-2017 MOBOTIX AG, Germany · http://www.mobotix.com/