Skip to main content
Version: 2.5.1

Line crossing

Line is a zone marked over the video stream. As soon as a person completely crosses this zone, OMNI Agent will send the results of body detection and tracking for this person to OMNI Platform or a third-party service.

In the camera preview, the line zone is indicated in light red, and turns red when crossed.

How to add lines​

  1. Click on the gear sign in the camera bar. Then click + in the upper right corner of the opened tab.

    img.png

  2. Fill in the line name and select a "Line*" type. Then mark 2 points on the video stream and set the size of the line zone using the arrow. After filling, click "Save".

    img.png

  3. Return to the main page of the dashboard. Now the added line is displayed on the camera preview.

    img.png

Line configuration​

To add or change a line, open the run_params.json configuration file and edit the following fields of the mutlistream_ROI object:

  • force_track_termination_on_lost_event: If the field is disabled, a person's track continues, even if the person leaves the camera's field of view for some time (For example, if there are obstacles in the camera's field of view).

  • regions: array of objects (regions of interest). The line zone coordinates are the coordinates of ROI bounding points.

An example of an object in the regions array:

"regions": [
{ // object (ROI)
    "name": "_region_name_", // ROI name
    "points": [ // coordinates of ROI bounding points
        {
            "x": 0,
            "y": 0.975 // in relative frame coordinates
        },
        {
            "x": 1,
            "y": 0.975
        },
        {
            "x": 0.5,
            "y": 0.5
        }
    ],
    "trigger_settings": // a key object that converts ROI into a line
    {
        "is_roi": true, // "true" means that <ShortProductName/> Agent will transfer both processes with lines and ROI
        "direction": // entry direction vector (crossing the line zone in the opposite direction is considered exit)
        {
            "x": 0.5,
            "y": 0.3,
        }
    }
    "uuid": "6acb27c7-c967-46ed-a32f-0085c0454c4c" // Line uuid. Added automatically if absent. 
  }
]