doc/api: extended the object mode section in the stream.md

doc/api: extended the object mode section in the stream.md

Added a section to describe the object mode a little bit more, especially the internal handling when piping from object mode into other streams.

Checklist

• [x ] commit message follows commit guidelines