@@ -2504,8 +2504,12 @@ Animation effects {#animation-effects}
25042504
25052505### Local time ### {#local-time-section}
25062506
2507- The <dfn>local time</dfn> of an [=animation effect=] at a given moment
2508- is based on the first matching condition from the following:
2507+ The <dfn>local time</dfn> of an [=animation effect=]
2508+ represents the [=animation/current time=]
2509+ provided by its [=associated animation=] ,
2510+ determining the progress of the [=animation effect=] .
2511+ At a given moment,
2512+ it is based on the first matching condition below:
25092513
25102514 <div class=switch>
25112515
@@ -2519,45 +2523,75 @@ Animation effects {#animation-effects}
25192523
25202524 </div>
25212525
2522- ### Time Spaces ### {#iteration -time-space }
2526+ ### Time spaces ### {#effect -time-spaces }
25232527
25242528<div class=informative-bg>
25252529<em> This section is non-normative</em>
25262530
25272531 In Web Animations all times are relative to some point of reference.
2528- These different points of reference produce different <em > time spaces</em > .
2532+ These different points of reference produce different <dfn >time spaces</dfn > .
25292533
25302534 This can be compared to coordinate spaces
25312535 as used in computer graphics.
2532- The zero time of a time space is analogous
2536+ The zero time of a [= time space=] is analogous
25332537 to the origin of a coordinate space.
25342538
2535- We can describe animations that repeat
2536- as establishing a new time space
2537- each time the animation repeats:
2538- the <em> iteration time space</em> .
2539-
2540- <em> Iteration time space</em> is a time space
2541- whose zero time is the beginning
2542- of an animation effect's current iteration.
2539+ Within the [=Web Animations model=]
2540+ we define progress of an [=animation effect=] on the basis of its [=active time=] ,
2541+ which is a time relative to the beginning of its [=active interval=] --
2542+ thus a time in the [=active time space=] .
25432543
2544- Within the Web Animations model we also refer to [=active time=] ,
2545- which is a time relative to the beginning of the active interval.
2546- This time space, however, is internal to the model
2544+ Note: This time space is internal to the model
25472545 and not exposed in the programming interface or in markup.
25482546
2547+ We can further describe animations that repeat
2548+ as establishing a new [=time space=]
2549+ each time the animation repeats:
2550+ the [=iteration time space=] .
2551+
2552+ The [=animation effect=] thus translates the [=animation/current time=]
2553+ provided by the [=associated animation=]
2554+ through a series of [=time spaces=] :
2555+ * the <dfn noexport>local time space</dfn> ,
2556+ relative to the [=start time=] of the [=associated animation=] ,
2557+ yielding the [=local time=]
2558+ * the <dfn noexport>active time space</dfn> ,
2559+ relative to the start of the [=active interval=] ,
2560+ yielding the [=active time=]
2561+ * the <dfn noexport>iteration time space</dfn> ,
2562+ relative to the start of the [=animation effect=] ’s current iteration,
2563+ yielding the <dfn>iteration time</dfn>
2564+
25492565 These time spaces are illustrated below.
25502566
25512567 <figure>
25522568 <img src="images/time-spaces.svg" width="600"
2553- alt="A comparison of local time, active time, and iteration time.">
2569+ alt="A comparison of local time, active time, and iteration time.
2570+ Local time crosses zero at the start time of the animation,
2571+ and rises linearly.
2572+ Active time is zero until the start of the active interval,
2573+ at which point it rises linearly to the end time,
2574+ beyond which it remains at its maximum value.
2575+ Iteration time is likewise zero until the start of the active interval,
2576+ and rises linearly,
2577+ but restarts at zero at the start of every new iteration,
2578+ and remains at its halfway point from the end time onward.">
25542579 <figcaption>
2555- A comparison of [=local time=] , [=active time=] , and iteration time
2580+ A comparison of [=local time=] , [=active time=] , and [= iteration time=]
25562581 for an animation with an [=iteration duration=] of 1s
25572582 and an [=iteration count=] of 2.5.
2583+ The [=animation/start time=] defined by the [=animation=]
2584+ and [=animation effect/end time=] defined by the [=animation effect=]
2585+ are also annotated.
25582586 </figcaption>
25592587 </figure>
25602588
2589+ In addition to these time spaces
2590+ we can also refer to the <dfn noexport>document time space</dfn> ,
2591+ which is time space of the [=time values=]
2592+ of the [=default document timeline=] of the {{Document}}
2593+ of the [=current global object=] .
2594+
25612595 Note: While the time spaces themselves are not bounded,
25622596 Web Animations defines [=active time=] and the [=iteration progress=]
25632597 such that they are clamped to a set range as shown in the diagram.
@@ -2566,12 +2600,6 @@ Animation effects {#animation-effects}
25662600 the procedure for calculating the [=active time=]
25672601 defined in [[#calculating-the-active-time]]
25682602 will never return a negative value.
2569-
2570- In addition to these time spaces
2571- we can also refer to the <em> document time space</em> ,
2572- which is time space of the [=time values=]
2573- of the [=default document timeline=] of the {{Document}}
2574- of the [=current global object=] .
25752603</div>
25762604
25772605### The active interval, duration, and delays ### {#the-active-interval}
0 commit comments