[web-animations] Introduce ComputedKeyframe dictionary type.

Thu, 17 Apr 2014 17:03:49 +0900

author
Brian Birtles <birtles@gmail.com>
date
Thu, 17 Apr 2014 17:03:49 +0900
changeset 1480
bac24dfe38fd
parent 1479
1f5def45c73d
child 1481
9177e3621841

[web-animations] Introduce ComputedKeyframe dictionary type.

See thread starting here: http://lists.w3.org/Archives/Public/public-fx/2014AprJun/0009.html

web-animations/index.html file | annotate | diff | comparison | revisions
     1.1 --- a/web-animations/index.html	Thu Apr 17 16:42:28 2014 +0900
     1.2 +++ b/web-animations/index.html	Thu Apr 17 17:03:49 2014 +0900
     1.3 @@ -4372,8 +4372,8 @@
     1.4                interface</a> are required to maintain the original null values as
     1.5                well as calculating the computed offsets.
     1.6                This is because the <code>getFrames</code> method of the
     1.7 -              <a>Timing</a> interface returns keyframe offsets both before
     1.8 -              and after applying spacing.
     1.9 +              <a>KeyframeEffect</a> interface returns keyframe offsets both
    1.10 +              before and after applying spacing.
    1.11              </p>
    1.12            </div>
    1.13            <div class="issue">
    1.14 @@ -7080,11 +7080,11 @@
    1.15                animation model calculations.
    1.16              </p>
    1.17            </dd>
    1.18 -          <dt>sequence&lt;Keyframe&gt; getFrames()</dt>
    1.19 +          <dt>sequence&lt;ComputedKeyframe&gt; getFrames()</dt>
    1.20            <dd>
    1.21              <p>
    1.22                Returns the <a>keyframes</a> that make up this effect as
    1.23 -              a sequence of <a title="Keyframe interface">Keyframe</a> objects.
    1.24 +              a sequence of <a>ComputedKeyframe</a> objects.
    1.25              </p>
    1.26              <p>
    1.27                The value returned differs from the <var>frames</var> parameter
    1.28 @@ -7097,12 +7097,13 @@
    1.29                    class="sectionRef"></a> is applied to <var>frames</var> which
    1.30                    may result in some frames being removed or re-ordered and some
    1.31                    properties being removed.
    1.32 +                  This normalization will also cause a single <a
    1.33 +                  title="Keyframe interface">Keyframe</a> object to be replaced
    1.34 +                  with a sequence.
    1.35                <li>The result of computing the <a>keyframe offset</a>
    1.36 -                  of each <a title="Keyframe interface">Keyframe</a>
    1.37 -                  as defined in <a href="#spacing-keyframes"
    1.38 -                  class="sectionRef"></a> is stored in the
    1.39 -                  <code>computedOffset</code> property of each frame as
    1.40 -                  a Number.
    1.41 +                  of each <a>keyframe</a> as defined in <a
    1.42 +                  href="#spacing-keyframes" class="sectionRef"></a> is stored in
    1.43 +                  the <code>computedOffset</code> member of each frame.
    1.44              </ul>
    1.45            </dd>
    1.46            <dt>void setFrames(object frames)</dt>
    1.47 @@ -7304,13 +7305,6 @@
    1.48              </p>
    1.49            </dd>
    1.50          </dl>
    1.51 -        <div class="note">
    1.52 -          <a title="Keyframe interface">Keyframe</a> objects returned by the
    1.53 -          <code>getFrames</code> method of <a>KeyframeEffect</a> include an
    1.54 -          additional Number property <code>computedOffset</code> representing
    1.55 -          the <a>keyframe offset</a> as calculated by <a
    1.56 -          href="#spacing-keyframes" class="sectionRef"></a>.
    1.57 -        </div>
    1.58          <section>
    1.59            <h4>Processing a <code>Keyframe</code> object</h4>
    1.60            <div class="note">
    1.61 @@ -7468,6 +7462,22 @@
    1.62          </section>
    1.63        </section>
    1.64        <section>
    1.65 +        <h3>The <code>ComputedKeyframe</code> dictionary</h3>
    1.66 +        <p>
    1.67 +          <a>Keyframes</a> returned by
    1.68 +          <code><a>KeyframeEffect</a>.getFrames</code> are represented using
    1.69 +          <a>ComputedKeyframe</a> dictionary objects.
    1.70 +        </p>
    1.71 +        <dl class="idl" title="dictionary ComputedKeyframe : Keyframe">
    1.72 +          <dt>double computedOffset</dt>
    1.73 +          <dd>
    1.74 +            The <a>keyframe offset</a> calculated for this <a>keyframe</a> as
    1.75 +            a result of applying the spacing procedure defined in <a
    1.76 +            href="#spacing-keyframes" class="sectionRef"></a>.
    1.77 +          </dd>
    1.78 +        </dl>
    1.79 +      </section>
    1.80 +      <section>
    1.81          <h3>The <code>MotionPathEffect</code> interface</h3>
    1.82          <p>
    1.83            <a>Motion path animation effects</a> are
    1.84 @@ -8171,6 +8181,8 @@
    1.85              computed <a>keyframe offset</a> as <code>computedOffset</code> and
    1.86              apply the normalization of keyframes defined in <a
    1.87              href="#normalizing-a-sequence-of-keyframes" class="sectionRef"></a>.
    1.88 +        <li>Introduced the <a>ComputedKeyframe</a> dictionary for representing
    1.89 +            the return values from <code><a>KeyframeEffect</a>.getFrames</code>.
    1.90          <li>Removed the <code>OneOrMoreKeyframes</code> typedef since it is no
    1.91              longer a valid WebIDL union. Replaced useage of
    1.92              <code>OneOrMoreKeyframes</code> with <code>object</code> and defined

mercurial