Timeline

Whether the animation should always play from the beginning. When false, the animation will resume from its current position when restarted. Defaults to false.

Whether the animation should begin playing immediately.

Duration to wait before starting the animation, in seconds.

Duration the animation should take to complete, in seconds.

End date of the timeline's time range.

Duration to hold the end of the animation before repeating, in seconds.

Read-only LiveData mirror of this timeline's AnimationState, updated via setLiveState on every play/pause/stop/resume transition. Currently unobserved by any caller in this codebase but kept for future state-change tracking.

Current playhead position, from 0.0 (start) to 1.0 (end). The custom getter always recomputes from the live phase/meld state (or the stored date when idle) via getSeekBarPosition rather than returning the assigned backing-field value directly — use goTo or setProgress to actually move playback.

Whether the animation should restart after completing playback.

Start date of the timeline's time range.

Factor used to scale the time of the animation where a value of 1 is normal speed, 0.5 is half speed, and 2 is double speed, etc. Only positive values are allowed.

Restricts the animation to a specific date range relative to the overall start and end date. This is useful if you want to limit the animation to a subset of the overall time range without changing the overall start and end date values.

Update the map to reflect a position on the timeline from 0.0 to 1.0

Moves every child TimeAnimation (and this timeline) to date.

Advances the playhead past the start time by the given number of milliseconds.

Pauses the animation at its current position.

Begins playing the animation.

Toggles playback: if not already playing, seeks to positionInput (or the position matching storedDate when null) and transitions to AnimationState.playing, starting the frame- driven play job and bumping reqGeneration so per-layer requested-interval bookkeeping from before this play session is treated as stale; if already playing, stops instead. When startImmediately is false and delay is greater than 0, playback first waits out the configured start delay before advancing.

Begins playing the animation from the specified date where date is within the time range between the timeline's startDate and endDate values.

Stops playing the animation if currently playing and updates the playhead back to its original starting position.

Restarts playback: forces AnimationState.playing, propagates the restart to every child animation, and notifies listeners via AnimationEvent.RESTART.

Resumes playing the animation from its current position, such as after being paused.

Updates the timeline end date by applying the specified time offset to the relative date. If no relative date is provided, then the current time and date will be used.

Updates the timeline end date by calculating the date using a relative time string, such as "-2 hours" or "1 day".

Updates the timeline start date by applying the specified time offset to the relative date. If no relative date is provided, then the current time and date will be used.

Updates the timeline start date by calculating the date using a relative time string, such as "-2 hours" or "1 day".

Stops playing the animation. The timeline position will be updated to the time closest to the current time, which may be at the start or end of the time range or somewhere in between.

Toggles the current state of the animation between paused and playing if currently active.

Renamed from trigger in js since type-erasure caused signature clash