Skip to content

Commit f272afc

Browse files
committed
[web-animations-1] Strengthen DFNs for time spaces
* give local time a proper DFN * tweak Time Spaces to fit as an overview for more than just the iteration section * use proper dfn markup for the various terms defined in the Time Spaces overview
1 parent 5fce595 commit f272afc

File tree

1 file changed

+52
-24
lines changed

1 file changed

+52
-24
lines changed

web-animations-1/Overview.bs

Lines changed: 52 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -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

Comments
 (0)