({{, (RefLink[AnimationTimeIndex, paclet:ref/AnimationTimeIndex]) 
is an option to (RefLink[Animator, paclet:ref/Animator]) and related functions that specifies the current time index for the animator.}})

OpenersNotesSection(Spacer1)Details

(RefLink[AnimationTimeIndex, paclet:ref/AnimationTimeIndex]) runs from 0 to the duration of the animation, in seconds.

(RefLink[AnimationTimeIndex, paclet:ref/AnimationTimeIndex]) is 0 at the animator's minimum value and duration at the maximum.

The typical default setting of AnimationTimeIndex -> (RefLink[Automatic, paclet:ref/Automatic]) will calculate the appropriate value from the animation.

While (RefLink[Animator, paclet:ref/Animator])[(RefLink[Dynamic, paclet:ref/Dynamic])[var],…] is running, changing var outside the animator will have no effect on (RefLink[AnimationTimeIndex, paclet:ref/AnimationTimeIndex]).

(RefLink[AnimationTimeIndex, paclet:ref/AnimationTimeIndex]) varies continuously, even for discrete animations.

(RefLink[AnimationDirection, paclet:ref/AnimationDirection]) has no impact on (RefLink[AnimationTimeIndex, paclet:ref/AnimationTimeIndex]).

OpenersPrimaryExamplesSection(Spacer1)Examples  (4)

OpenersExampleSection0(Spacer1)Basic Examples  (2)

With default option settings, (RefLink[AnimationTimeIndex, paclet:ref/AnimationTimeIndex]) runs from 0 to 5:

DynamicModule[{i},{Animator[0,{0,100},AnimationTimeIndex->Dynamic[i]],Dynamic[i]}]

Changing the (RefLink[DefaultDuration, paclet:ref/DefaultDuration]) will change the maximum time index:

DynamicModule[{i},{Animator[0,{0,1},AnimationTimeIndex->Dynamic[i],DefaultDuration -> 50],Dynamic[i]}]

OpenersExampleSection1(Spacer1)Scope  (1)

Interactively changing a paused animator will also change the value of (RefLink[AnimationTimeIndex, paclet:ref/AnimationTimeIndex]):

DynamicModule[{x,i=0.},{Animator[Dynamic[x],{0,1},AnimationTimeIndex -> Dynamic[i],AnimationRunning -> False],Dynamic[{x,i}]}]

OpenersExampleSection3(Spacer1)Possible Issues  (1)

To change a running animator programmatically, change the value of (RefLink[AnimationTimeIndex, paclet:ref/AnimationTimeIndex]), not the animation variable:

DynamicModule[{x,i},{Animator[Dynamic[x],{0,1},AnimationTimeIndex->Dynamic[i]],Button["x=0",x=0],Button["i=0",i=0]}]

({{DocumentationFooterIconsRelatedFunction.png, ({{See Also}, {(RefLink[DefaultDuration, paclet:ref/DefaultDuration])  ▪  (RefLink[AnimationRunTime, paclet:ref/AnimationRunTime])  ▪  (RefLink[AnimationRate, paclet:ref/AnimationRate])  ▪  (RefLink[RefreshRate, paclet:ref/RefreshRate])  ▪  (RefLink[Rescale, paclet:ref/Rescale])}})}})

({{DocumentationFooterIconsRelatedGuide.png, ({{Related Guides}, {▪(RefLinkPlain[Options & Styling for Interactive Manipulation, paclet:guide/OptionsAndStylingForInteractiveManipulation])}})}})