Skip to content

Commit a49f222

Browse files
committed
[web-animations-1][editorial] Proper dfns for the timing model and animation model.
Also better cross-linking.
1 parent 5554b4d commit a49f222

File tree

1 file changed

+34
-32
lines changed

1 file changed

+34
-32
lines changed

web-animations-1/Overview.bs

Lines changed: 34 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -459,39 +459,41 @@ Specification conventions {#spec-conventions}
459459
Web Animations model overview {#web-animations-model-overview}
460460
=============================
461461

462-
<div class=informative-bg>
463-
<em>This section is non-normative</em>
464-
465462
At a glance, the [=Web Animations model=] consists
466463
of two largely independent pieces:
467-
a <em>timing model</em> and an <em>animation model</em>.
464+
a [=timing model=] and an [=animation model=].
468465
The roles of these pieces are as follows:
469466

470-
: Timing model
467+
: <dfn id="timing-model-dfn">timing model</dfn>
471468
::
472469
Takes a moment in time and converts it to a proportional distance
473470
within a single iteration of an animation,
474-
called the <em>iteration progress</em>.
475-
The <em>iteration index</em> is also recorded
471+
called the <dfn>iteration progress</dfn>.
472+
The <dfn>iteration index</dfn> is also recorded
476473
since some animations vary each time they repeat.
474+
The [=Web Animations timing model=] is defined in [[#timing-model]].
477475

478-
: Animation model
476+
: <dfn id="animation-model-dfn">animation model</dfn>.
479477
::
480-
Takes the <em>iteration progress</em> and <em>iteration index</em> values
481-
produced by the timing model
482-
and converts them into a series of values
483-
to apply to the target properties.
478+
Takes the [=iteration progress=] and [=iteration index=] values
479+
produced by the [=timing model=]
480+
and converts them into a series of corresponding values
481+
to apply to the [=target properties=].
482+
The [=Web Animations animation model=] is defined in [[#animation-model]].
483+
484+
<div class=informative-bg>
485+
<em>This section is non-normative</em>
484486

485487
Graphically, this flow can be represented as follows:
486488
<figure>
487489
<img src="images/timing-and-animation-models.svg" width="600"
488490
alt="Overview of the operation of the Web Animations model.">
489491
<figcaption>
490-
Overview of the operation of the Web Animations model.<br>
491-
The current time is input to the timing model
492-
which produces an iteration progress value and an iteration index.<br>
493-
These parameters are used as input to the animation model
494-
which produces the property values to apply.
492+
Overview of the operation of the [=Web Animations model=].<br>
493+
The current time is input to the [=timing model=]
494+
which produces an [=iteration progress=] value and an [=iteration index=].<br>
495+
These parameters are used as input to the [=animation model=]
496+
which produces the [=target property=] values to apply.
495497
</figcaption>
496498
</figure>
497499

@@ -502,14 +504,14 @@ Web Animations model overview {#web-animations-model-overview}
502504
* takes 2 seconds every time, and
503505
* changes the width of a rectangle from 50 pixels to 100 pixels.
504506

505-
The first three points apply to the timing model:
507+
The first three points describe the [=timing model=]:
506508
at a time of 6 seconds, it calculates that the animation should be
507509
half-way through its second iteration
508510
and produces the result 0.5.
509511
The animation model then uses that information to calculate a width.
510512

511-
This specification begins with the timing model
512-
and then proceeds to the animation model.
513+
This specification begins with the [[#timing-model|timing model]]
514+
and then proceeds to the [[#animation-model|animation model]].
513515
</div>
514516

515517
<!--
@@ -526,10 +528,10 @@ Timing model {#timing-model}
526528
============
527529

528530
This section describes and defines the behavior
529-
of the Web Animations timing model.
531+
of the <dfn>Web Animations [=timing model=]</dfn>.
530532

531-
Timing model overview {#timing-model-overview}
532-
---------------------
533+
Timing model characteristics {#timing-model-overview}
534+
----------------------------
533535

534536
<div class=informative-bg>
535537
<em>This section is non-normative</em>
@@ -539,8 +541,8 @@ Timing model overview {#timing-model-overview}
539541

540542
### Stateless ### {#stateless}
541543

542-
The Web Animations timing model operates by taking an input time
543-
and producing an output iteration progress.
544+
The Web Animations [=timing model=] operates by taking an input time
545+
and producing an output [=iteration progress=].
544546
Since the output is based solely on the input time
545547
and is independent of previous inputs,
546548
the model can be described as stateless.
@@ -1988,7 +1990,7 @@ Waiting for the associated effect</h4>
19881990

19891991
<div class=informative-bg>
19901992
The rate of play of an animation can be controlled
1991-
by setting its <em>playback rate</em>.
1993+
by setting its [=playback rate=].
19921994
For example, setting a playback rate of 2 will cause
19931995
the animation's [=animation/current time=]
19941996
to increase at twice the rate of its [=timeline=].
@@ -2070,7 +2072,7 @@ Waiting for the associated effect</h4>
20702072

20712073
In order to produce seamless changes to
20722074
the [=playback rate=] of an [=animation=],
2073-
animation's may have a <dfn>pending playback rate</dfn>
2075+
animations may have a <dfn>pending playback rate</dfn>
20742076
that defines a playback rate to be applied
20752077
after any necessary synchronization has taken place
20762078
(for the case of animations running in a different thread or process).
@@ -3493,7 +3495,7 @@ Time transformations {#time-transformations}
34933495
The iteration progress {#the-iteration-progress}
34943496
----------------------
34953497

3496-
The <dfn>iteration progress</dfn> of an [=animation effect=]
3498+
The [=iteration progress=] of an [=animation effect=]
34973499
is simply its [=transformed progress=].
34983500

34993501

@@ -3516,14 +3518,14 @@ Animation model {#animation-model}
35163518
<em>This section is non-normative</em>
35173519

35183520
For some kinds of [=animation effects=],
3519-
the Web Animations <em>animation model</em>
3521+
the <dfn>Web Animations [=animation model=]</dfn>
35203522
takes the [=iteration progress=] and [=current iteration=] values
3521-
produced by the <em>timing model</em>
3523+
produced by the [=Web Animations timing model|timing model=]
35223524
and uses them to calculate a corresponding output.
35233525

35243526
The output of each such animation effect
35253527
is then combined with that of others using an [=effect stack=]
3526-
before being applied to the target properties
3528+
before being applied to the [=target properties=]
35273529
(see [[#combining-effects]]).
35283530

35293531
</div>
@@ -5173,7 +5175,7 @@ The {{AnimationEffect}} interface {#the-animationeffect-interface}
51735175
::
51745176
The [=animation effect=]’s [=iteration start=] property,
51755177
which is a finite real number greater than or equal to zero
5176-
representing the iteration index at which the [=animation effect=] begins
5178+
representing the [=iteration index=] at which the [=animation effect=] begins
51775179
and its progress through that iteration.
51785180

51795181
For example, a value of 0.5 indicates that

0 commit comments

Comments
 (0)