Accumulate stream items until triggered to flush

Use This When

• Batching video frames for efficient batch inference on GPU models
• Grouping detections or events into windows before aggregation or analysis
• Building snapshot or recording logic triggered by external conditions
• Creating frame buffers that flush on specific events or intervals

What It Does

• Accumulates incoming messages into a list while boolean trigger input is true
• Flushes accumulated batch as output list when trigger transitions to false
• Resets internal buffer after each flush to start fresh collection
• Generic over any message type; works with images, detections, strings, numbers

Works Best With

• Frame rate control or event detection → this component → batch inference or file writers
• Periodic triggers controlling when accumulated data gets processed
• Any pipeline needing windowed or triggered batch operations

Caveats

• Buffer grows in memory until flushed; configure triggers to prevent unbounded accumulation
• Empty batches not emitted by default unless allow_empty=true
• Output timing depends entirely on trigger; missed trigger means indefinite buffering