ParallelTimeline
¶
Kanzi animation system consists of animations and timelines:
Parallel timeline allows you to group timelines which Kanzi plays at the same time. Use this timeline to organize collections of timelines and create a composition of timelines.
You can add child timelines to your parallel timeline by calling its addChild() function. You can also adjust the position of a child timeline, inside your parallel timeline, by setting the start time of the child timeline. A child timeline's start and global time are defined in the content time space of a parallel timeline. You can clip a child timeline by giving it a negative start time and the portion before the zero time will be clipped.
You can not add a child timeline once a parellel timeline has started animating, that is, after the playback of the parallel timeline has been added to a timeline clock. Doing so will result in an undefined behavior.
Since a parallel timeline is a group of its child timelines, the content duration of parallel timeline is defined as the union of its child timeline's durations, and is affected by their respective start times. For example, if you add a single timeline with a duration of 10 milliseconds and a start time of 5 milliseconds as a child to a parallel timeline, then the content duration of your parallel timeline would become 15 milliseconds.
Do note that a parallel timeline without any children has a 0 millisecond content duration.
Timeline properties affecting the playback, such as start time, repeat count, duration scale factor, direction behavior, clip start and clip duration, which are specified in parallel timeline, also affect its child timelines. For example, if direction behavior of parallel timeline is set to reverse, then all its child timelines are played in reverse manner, from the end to beginning. In this case, the time for child timelines will appear as going backwards.
Inherits properties and message types from ParallelTimelineMetadata.
Creates a parallel timeline.
| anonymous | (string) | Unused parameter |
| (ParallelTimeline) | The created parallel timeline. |
Creates a parallel timeline.
| (ParallelTimeline) | Parallel timeline. |