Check Geometry Within ROI

@bleenco1 VersionUtility

Spatial containment test: takes a geometry item (a box, point, mask, polygon or point list) and an ROI shape, and emits a Bool indicating whether the item lies inside or outside the region under the configured rule.

How it fits

Typical backends

Detect objects, test each detection against a fixed region of interest, and keep only the ones inside before publishing.

Segment a frame, test mask coverage against a region, and publish the boolean result over HTTP for an occupancy monitor.

Caveats

I/O contractThe test rule depends on the item shape: a rectangle is tested by bbox_mode (its centre, or its coverage fraction against bbox_iou_threshold), while masks and polygons use the overlap fraction against mask_min_overlap.
Parameter interactionpass_when inverts the final answer, so the same containment test can report true for items inside or true for items outside the region without changing the geometry logic.
LimitationCoverage and overlap are computed as the fraction of the item that falls inside the ROI, not of the ROI covered by the item, so a tiny item fully inside a large region counts as fully covered.

Versions

5c696ebelatestdefault
Automated release
6/25/2026