NoesisGUI

Timeline hierarchy

Timeline.png

Timeline

http://msdn.microsoft.com/en-us/library/system.windows.media.animation.timeline.aspx

This is the base class for animation objects. It describes the majority of the properties that controls the direction, speed and duration of a single animation. It is important to understand the implication of these properties.

Methods
Name Sup Comments
CreateClock Yes  
Dependency Properties
Name Att Sup Comments
AccelerationRatioProperty No Yes  
AutoReverseProperty No Yes  
BeginTimeProperty No Yes  
DecelerationRatioProperty No Yes  
DesiredFrameRateProperty Yes No  
DurationProperty No Yes  
FillBehaviorProperty No Yes  
NameProperty No No  
RepeatBehaviorProperty No Yes  
SpeedRatioProperty No Yes  
Events
Name Sup Comments
Completed No  
CurrentGlobalSpeedInvalidated No  
CurrentStateInvalidated No  
CurrentTimeInvalidated No  
RemoveRequested No  

Members

  • Duration: is the time duration of one iteration of the animation. Generally, it is expressed in the TimeSpan form (for example, "0:1:2.4", where 0 is days, 1 hours, 2 minutes, 3 seconds and 4 milliseconds). The duration can also be Forever, Automatic (the duration it's defined by the timeline children if any, or by the returning value of NaturalDuration) or even null, telling that the animation will never start.
  • SpeedRatio: indicates the relative speed of the the clock time related to its parent time (or real time, if it has no parent). For example, a speed of "2" makes the clock runs twice as fast, so an animation with a duration of 10 seconds, will consume in 5 real seconds.
  • BeginTime: it's a TimeSpan indicating some time that must consume before the animation starts. The BeginTime is not affected by the local speedratio of the timeline.
  • Autoreverse: when true, the animation plays forward and when it's completed it plays backward, taking the same amount of time to complete. The BeginTime is ignored when running backwards, so a Timeline with a begintime of 1 second, a duration of 10 seconds and a speedratio 2, will take 11 seconds to complete (1 + 5 + 5).
  • RepeatBehavior: tells how many times the animation has to be executed, or during how many time. If its repeating times, for example an animation of 5 seconds with autoreverse and a repeact behavior of 1.5x will last 15s (5 forward, 5 backward and 5 forward). The same can be obtained if a timespan of 15 seconds is passed as RepeatBehavior.
  • Acceleration/DecelerationRatio: modifies slightly the linear interpolation of time to have an effect of spring in the start and end of the iteration time. More control on the animation can be done using one of the Easing functions that will be commented later.
  • FillBehavior: normally, when an animation ends, the final value is maintained in the target property (HoldEnd). The animated value can be removed at the end of the animation passing a Stop value here.

So in practice, the formula to calculate the total duration of a timeline should be (in case that RepeatBehavior sets the number of repetitions)

Formula1.png

or (in case that RepeatBehavior sets the repetition time)

Formula2.png

Methods

  • CreateClock: Creates a new clock to control the timeline. This method call internally AllocateClock, which is reimplemented in the inheritors of Timeline to create the adecuate clock

For more detail about the classes deriving from AnimationTimeline, see Single Timelines

For deriving classes from TimelineGroup, see Group Timelines

The MediaTimeline is not implemented yet.

© 2017 Noesis Technologies