Detected Zones Counters
Overview
Detected Zones Counters node counts rectangular detections inside configurable polygon zones and returns per-zone and combined totals.
Use this node after any detection node (for example Object Detection or General Object Detection) to build zone-based analytics — for example counting people in a restricted area, measuring occupancy per lane, or checking whether a specific product type is present in each region.
Input
Input Image
image requiredImage frame used for visualization overlays. Connect this to a camera or upstream image output.
Rectangular Objects
array requiredList of rectangular detection objects from an upstream node. Each object must include at least a Bounding Box (bbox: [x, y, width, height]). Optional fields such as Label, Confidence, and Points use defaults when missing.
Zones
array requiredZone polygon definitions. Each entry includes:
- Points — polygon vertices in image pixel coordinates
- Label — display name for the zone
- Hex Color — overlay color for the zone
Zone Configurations
arrayPer-zone behavior settings. Each entry corresponds to the zone at the same index in Zones and can include:
- Filters — label compare mode (
EQUALS,NOT_EQUALS,CONTAINS,NOT_CONTAINS,STARTS_WITH,ENDS_WITH,MATCHES_REGEX), filter value, optional case sensitivity, box width/height ranges, and OR grouping - Invert Zone — count objects outside the polygon instead of inside
- Moving Average Window Size / Moving Average Type (
MEAN,MEDIAN,MODE,MIN,MAX) - Bounding Box Color Inside Zone / Outside Zone
When the connected rectangular objects include point/keypoint data, Point Zone Filters can also appear (point IDs, point-label compare mode/value/type, invert, colors).
Point Position
stringWhich point of each bounding box is used for zone membership tests.
Values: TOTAL, TOP, MIDDLE (default), BOTTOM
Overlay results
boolean requiredWhether to draw zones and counts on the output frame.
Default: true
When enabled, advanced overlay options can include Zones to Draw, Draw Point, and Show Numbers.
Output
Output Image
imageOutput frame with zone polygons and counts drawn when overlay is enabled.
Combined Zones
objectAggregated result across zones:
- Has Objects
- Has Objects Timestamp
- Count inside Zones
- Count outside Zones
- Labels inside Zones
Zone 1 … Zone 8
objectPer-zone ports with the same shape as Combined Zones (Has Objects, timestamp, count inside/outside, labels inside).