Skip to content

Commit b271b42

Browse files
committed
[web-animations-1] De-dup and integrate Active Interval section
1 parent 532ee01 commit b271b42

File tree

1 file changed

+47
-59
lines changed

1 file changed

+47
-59
lines changed

web-animations-1/Overview.bs

Lines changed: 47 additions & 59 deletions
Original file line numberDiff line numberDiff line change
@@ -2502,79 +2502,67 @@ Animation effects {#animation-effects}
25022502
Subsequent levels of this specification
25032503
will define further types of [=animation effects=].
25042504

2505-
### The active interval ### {#the-active-interval}
2505+
### The active interval, duration, and delays ### {#the-active-interval}
25062506

2507-
<div class=informative-bg>
2508-
2509-
The period that an [=animation effect=] is scheduled to run
2510-
is called its [=active interval=].
2511-
Each [=animation effect=] has only one such interval.
2512-
2513-
The lower bound of the [=active interval=] typically corresponds
2514-
to the [=start time=] of
2515-
the [=animation=] associated with this [=animation effect=],
2516-
but can be shifted by a [=start delay=] on the [=animation effect=].
2517-
2518-
The upper bound of the interval is determined
2519-
by the [=active duration=].
2520-
2521-
The relationship between
2522-
the [=start time=], [=start delay=], and [=active duration=]
2523-
is illustrated below.
2524-
2525-
<figure>
2526-
<img src="images/active-interval-examples.svg" width="600"
2527-
alt="Examples of the effect of the start dela
2528-
on the endpoints of the active interval">
2529-
<figcaption>
2530-
Examples of the effect of the [=start delay=]
2531-
on the endpoints of the [=active interval=].<br>
2532-
(a) An animation effect with no delay;
2533-
the [=start time=] and beginning of the [=active interval=]
2534-
are coincident.<br>
2535-
(b) An animation effect with a positive delay;
2536-
the beginning of the [=active interval=]
2537-
is deferred by the delay.<br>
2538-
(c) An animation effect with a negative delay;
2539-
the beginning of the [=active interval=]
2540-
is brought forward by the delay.
2541-
</figcaption>
2542-
</figure>
2543-
2544-
An [=end delay=] can also be specified
2545-
but is primarily only of use when sequencing animations.
2546-
2547-
</div>
2548-
2549-
[=Animation effects=] define an <dfn>active interval</dfn>
2507+
[=Animation effects=] define an <dfn>active interval</dfn>,
25502508
which is the period of time during which the effect
2551-
is scheduled to produce its effect--
2552-
with the exception of [=fill modes=],
2553-
which apply outside the [=active interval=].
2509+
is scheduled to produce its effect
2510+
(excepting [=fill modes=],
2511+
which apply outside the [=active interval=]).
2512+
Each [=animation effect=] has only one such interval.
25542513

25552514
The lower bound of the [=active interval=]
2556-
is defined by the [=start delay=].
2557-
2558-
The <dfn>start delay</dfn> of an [=animation effect=]
2559-
is a signed offset from the [=start time=] of the [=animation=]
2560-
with which the animation effect is associated.
2515+
by default corresponds to the [=start time=] of the [=associated animation=],
2516+
but can be shifted by the <dfn>start delay</dfn>,
2517+
which is a signed offset from the [=start time=] of the [=animation=].
25612518

2562-
The length of the [=active interval=] is called the [=active duration=],
2519+
The length of the [=active interval=] is called the <dfn>active duration</dfn>,
25632520
the calculation of which is defined in [[#calculating-the-active-duration]].
2521+
Its length determines the upper bound of the [=active interval=].
2522+
2523+
<div class=informative-bg>
2524+
2525+
The relationship between
2526+
the [=start time=], [=start delay=], and [=active duration=]
2527+
is illustrated below.
2528+
2529+
<figure>
2530+
<img src="images/active-interval-examples.svg" width="600"
2531+
alt="Examples of the effect of the start dela
2532+
on the endpoints of the active interval">
2533+
<figcaption>
2534+
Examples of the effect of the [=start delay=]
2535+
on the endpoints of the [=active interval=].<br>
2536+
(a) An animation effect with no delay;
2537+
the [=start time=] and beginning of the [=active interval=]
2538+
are coincident.<br>
2539+
(b) An animation effect with a positive delay;
2540+
the beginning of the [=active interval=]
2541+
is deferred by the delay.<br>
2542+
(c) An animation effect with a negative delay;
2543+
the beginning of the [=active interval=]
2544+
is brought forward by the delay.
2545+
</figcaption>
2546+
</figure>
2547+
</div>
25642548

25652549
Similar to the [=start delay=],
25662550
an [=animation effect=] also has an <dfn>end delay</dfn>,
2567-
which is primarily of use when sequencing animations
2551+
which is primarily of use when sequencing one [=animation effect=]
25682552
based on the [=end time=] of another [=animation effect=].
2569-
Although this is typically only useful in combination with sequence effects
2553+
2554+
The <dfn for="animation effect">end time</dfn>,
2555+
of an [=animation effect=]
2556+
is the result of evaluating
2557+
<code>max(<a>start delay</a> + <a>active duration</a> + <a>end delay</a>, 0)</code>.
2558+
2559+
Note: Although the [=end delay=] is typically only useful
2560+
in combination with sequence effects
25702561
which are introduced in a subsequent level of this specification,
25712562
it is included here for the purpose of representing
25722563
the <a href="https://www.w3.org/TR/SVG/animate.html#MinAttribute"><code>min</code></a>
25732564
attribute in SVG ([[SVG11]], Chapter 19).
25742565

2575-
The <dfn>end time</dfn> of an [=animation effect=]
2576-
is the result of evaluating
2577-
<code>max(<a>start delay</a> + <a>active duration</a> + <a>end delay</a>, 0)</code>.
25782566

25792567
### Local time ### {#local-time-section}
25802568

@@ -3236,7 +3224,7 @@ Core animation effect calculations {#core-animation-effect-calculations}
32363224
The [=active duration=] is calculated as follows:
32373225

32383226
<blockquote>
3239-
<dfn>active duration</dfn> =
3227+
[=active duration=] =
32403228
<code><a>iteration duration</a> × <a>iteration count</a></code>
32413229
</blockquote>
32423230

0 commit comments

Comments
 (0)