Tracker Zones Count

Overview

Tracker Zones Count node counts tracked objects entering or leaving polygon zones and returns per-zone counters plus the list of counted objects.

Use this node after Tracker when you need linger-time or speed-aware zone analytics. For frame-by-frame detection counting without tracking, see Detected Zones Counters.

Input

Input Image

image required

Image frame used for visualization overlays. Connect this to a camera or upstream image output.

Tracked Objects

array required

Tracked objects from Tracker.

Zones for Counting

array required

Zone 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

Supports Zone 1–8 and optional Zone Point 1–8 labels.

Zone Configurations

array

Per-zone behavior settings. Each entry corresponds to the zone at the same index 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
• Bounding Box Color Inside Zone / Outside Zone (defaults #00ff00 / #ff0000)

When the connected tracked objects include point/keypoint data, Point Zone Filters can also appear (point IDs, point-label compare mode/value/type, invert, colors).

Point Position

string

Which point of each bounding box is used for zone membership tests.

Values: TOTAL, TOP, MIDDLE (default), BOTTOM

Minimum Linger Time until Count (ms)

integer required advanced

Minimum time in milliseconds an object must stay within a zone before it is counted. Set to 0 for immediate counting upon entry.

Default: 50

Maximum Object Speed for Counting

number required advanced

Objects moving faster than this speed are not counted. Set to 0 to disable speed filtering.

Default: 0

Object Speed Calculation Window Size (frames)

integer required advanced

Number of recent frames used for speed calculation.

Range: 1 to 100
Default: 5

Object Speed Decay Factor

number required advanced

Exponential decay factor for speed calculation. Higher values emphasize recent frames more strongly. Typical range: 0.1 (gradual) to 1.0 (steep).

Range: 0.0 to 1.0
Default: 0.5

Count Object Appearing in Zone

boolean required

Whether to count objects that appear inside the zone without crossing the boundary.

Default: false

Allow Recount

boolean required

Whether objects can be recounted if they cross zone boundaries multiple times.

Default: true

Deadzone Width (pixels)

number required advanced

Width of the deadzone near zone boundaries to reduce jitter double-counts. Set to 0 to disable.

Default: 5

Overlay results

boolean required

Whether to draw zones and counts on the output frame.

Default: true

When enabled, advanced overlay options can include Zones to Draw, Draw Point, Highlight When Counted, Show Numbers, Visualize Scale, and Show Deadzone.

Output

Output Image

image

Output frame with zone polygons and counts drawn when overlay is enabled.

Counted Objects

array

Objects that have been counted. Each entry can include:

• Track ID
• Label
• Direction ID — e.g. zone1_in, zone1_out, … zone8_in, zone8_out
• Timestamp (Unix ms)
• Speed (pixels/sec)
• Linger Time in Zone (ms)
• Extra Data

Zone 1 … Zone 8

object

Per-zone ports with:

• Has Objects
• Has Objects Timestamp
• Count Change
• Count inside Zone
• Count outside Zone
• Labels inside Zone