connectTo
(DOC) Creates an Universal object of Connections that associate of this timeline's object to the (chronologically) next object in another timeline that starts after this one ends.
For a connection from an object A (in this timeline) to an object B (in the other timeline), the interval of the connection is A.end, B.start. The original intervals for A and B can be accessed from within the Connection object.
This operation is not symmetric. All* objects in this timeline will be included in exactly one connection, but not all objects in the other timeline will be included, if there are no objects in this timeline that would connect to it. Similarly, objects in the other timeline can be connected to multiple times.
If the other timeline ends prematurely and there are still more objects in this timeline, you can optionally connect to the end of the bounds, in which case Connection.from will be null
. Otherwise, no connection will be generated.
Parameters
the other timeline to connect to
whether to connect to the end of the bounds if the other timeline ends prematurely