This documentation is for the upcoming version of the AI Manager
Read the documentation for the current version
Ctrlk
AI ManagerNx Meta
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Inclusive Masks

Limit inference to inside a drawn polygon.

Inclusive input masks ignore objects that are fully outside the drawn mask area. Create these masks on the video frame inside the AI Manager's Model Settings, in the Input Masks section.

Select Inclusive from the Mask Type dropdown:

Model Settings panel with the Input Mask Type dropdown open, showing Inclusive and Exclusive options
Choosing the Inclusive mask type

Click inside the mask's shape field to open the figure editor and draw the mask over the frame:

Figure editor dialog with an orange polygon shape drawn over part of a forest camera image, resize handles visible
Drawing an inclusive mask shape in the figure editor

Click OK to save the shape. A thumbnail preview appears in the mask's shape field, with a Display on video checkbox to show the mask as an overlay in Live View. Add more masks with the Add button.

Model Settings panel showing a completed inclusive input mask thumbnail, an orange polygon shape drawn over part of the camera image
Input Masks setting with an inclusive input mask

Confirm it in Live View: only detections inside the polygon are returned.

Live View showing an orange inclusive mask polygon over part of the frame, with only the people inside the polygon detected and labeled
Inclusive mask overlay in Live View

In practice, results overlap the polygon borders slightly because the anchor location for a detected object is the middle of the bottom of the detection box.

The center of the bottom of the bounding box is chosen for the anchor location because that is usually a good indication for where a person or object is standing on the ground. In a line-crossing scenario for example, this would make it easier to detect if a person crosses a certain line.

Using an input mask and a region of interest at the same time is not supported.

Click Apply for changes to take effect.

PreviousRegion of Interest
NextExclusive Masks

Last updated