Go to documentation repository
Page History
| Section | |||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Configuring the parameters
To create the Line crossing detector, do the following:
- Create the required detector and specify its parameters (see Configuring detectors and their sub-detectors).
- Below the created detector, click Create… → Line crossing.
By default, the detector is enabled and set to generate events when an object crosses a virtual line.
If necessary, you can change the detector parameters. The list of parameters is given in the table:
| Parameter | Value | Description | |||||
|---|---|---|---|---|---|---|---|
| Other | |||||||
| Enable | Yes | The detector is enabled by default. To disable the detector, select the No value | |||||
| No | |||||||
| Name | Line crossing | Enter the detector name or leave the default name | |||||
| Type | Line crossing | Name of the detector type (non-editable field) | |||||
| Advanced settings | |||||||
| X-axis offset | 15 | Specify the X-axis and Y-axis offsets as a percentage of the track area to receive events from the specified area. The values must be in the range [1, 40] | |||||
| Y-axis offset | 10 | ||||||
| Basic settings | |||||||
| Maximum object height | 100 | Specify the maximum object height as a percentage of the frame size for the detector to generate an event. The value must be in the range [0.05, 100]
| |||||
| Maximum object speed | 500 | Specify the maximum object speed per second for the detector to generate an event. The value must be in the range [0, 500]
| |||||
| Maximum object width | 100 | Specify the maximum object width as a percentage of the frame size for the detector to generate an event. The value must be in the range [0.05, 100]
| |||||
| Minimum object height | 0.1 | Specify the minimum object height as a percentage of the frame size for the detector to generate an event. The value must be in the range [0.05, 100]
| |||||
| Minimum object speed | 0 | Specify the minimum object speed per second for the detector to generate an event. The value must be in the range [0, 500]
| |||||
| Minimum object width | 0.1 | Specify the minimum object width as a percentage of the frame size for the detector to generate an event. The value must be in the range [0.05, 100]
| |||||
| Object class | All classes | Select the object class that must generate an event. The default value is All classes
| |||||
| Vehicle | |||||||
| Person | |||||||
By default, the entire frame is a detection area. If necessary, in the preview window, you can set one or more ignore areas (see Configuring the ignore area).
To save the parameters of the detector, click the Apply button. To cancel the changes, click the Cancel button.
Configuring a virtual line
To configure a virtual line, do the following:
- In the preview window:
- Specify the end points of the line :
Info title Note - The
- Specify the end points of the line :
After you create and select a line crossing detection tool, you can see a virtual "tripwire" line in the FoV.
To set up line crossing detection, do the following:
- Set up a virtual line in FoV.
- end points are connected by a two-color
dotted - dashed line. The
direction - directions of
the object's motion across - object movement through the line
is - are indicated by dotted arrows.
- For convenience of configuration, you can "freeze" the frame. Click the button. To cancel the action, click this button again.
- To hide the virtual line, click the button. To cancel the action, click this button again.
Action Result
Position Hover the cursor
on an over the end point and, holding down the left mouse button, move the mouse
Moves Moving the
line end point of a line
Position Hover the cursor
on over the line and, holding down the left mouse button, move the mouse Moving the line - By default,
Line crossing detection monitors object motion across the line in both directions. To suspend detection of motion in one - both directions of object movement through the line are detected. To stop the detection in the required direction, click the
button to that - button corresponding to this direction.
Note title Attention!
At - button corresponding to this direction.
- You must select at least one direction
must be selected - for detection.
- An unmonitored direction of object
motion - movement is indicated by a dimmed arrow.
- movement is indicated by a dimmed arrow.
If an object in FoV performs repetitive movements - In the frame, there can be situations when one and the same object frequently moves near the virtual line, it may cause excessive triggering of the detection tool
- which can cause the generation of excessive events. In this case, set an area within
- situation, we recommend specifying the area of the object 's track which must cross
- track that completely crosses the line completely
- to trigger the tool. To do it, set the X and Y offset values as percentage of track width and height.
- receive an event from the detector. For this, in the detector parameters, specify the X-axis and Y-axis offsets as a percentage of the track area width and height.
Configuration of the X-axis and Y-axis offsets depends on the Camera position parameter of the parent detector below which the Line crossing detector is created. For example, Neural tracker has the Camera position parameter (see Configuring the Neural tracker).- The Ceiling camera position:
For example, the green rectangle is the object track. If the X-axis and Y-axis offsets are set to 25%, an event is generated only if the red rectangle completely crosses the line. - The Wallcamera position:
For example, the green rectangle is the object track. If the X-axis offset is set to 30%, an event is generated only if the red segment completely crosses the line.
- The Ceiling camera position:
- Click the Apply button. Click the Cancel button to cancel the changes.
Set the end points of the line .
| title | Note |
|---|
| title | Note |
|---|
Here's an example: the green triangle is the track of the object. If you specify X and Y offset values as 25%, the tool will be triggered only if the entire red triangle goes beyond the virtual line.
Click the Apply button
Configuration of the Line crossing detector is complete.



