Configuration.handleStreamStart()
Description
Appends a handleStreamStart filter to the current pipeline layout.
A handleStreamStart filter calls back user scripts for the first Event in the input stream.
- INPUT - Any types of Events.
- OUTPUT - Same Events as input.
The user function that gets called will have an event object as parameter, which is whatever first event is in that stream. It can be any of the four types of events described in Concept: Events.
This filter passes every input event down to its output. It doesn't change how many or what events there are. However, since events are all just objects being passed around by reference, if you alter the event object itself, the change will be visible on the output, even though the references to the events are identical between the input and the output.
Syntax
pipy().pipeline().handleStreamStart(event => onStreamStart(event))
Parameters
handleStreamStart(handler)
A callback function that receives the first event passing through the filter.
The same Configuration object.