Remove AnimationTimeline.toTimelineTime

Author: birtles

web-animations/index.html

@@ -5368,87 +5368,6 @@ <h3>The <code>AnimationTimeline</code> interface</h3>
               sequence number</a>.
             </p>
           </dd>
-          <dt>double? toTimelineTime (double otherTime,
-                                      AnimationTimeline other)</dt>
-          <dd>
-            <p>
-              Returns the <a>time value</a>, <em>otherTime</em>, from another
-              <a>AnimationTimeline</a> also tied to the
-              <a>global clock</a>, <em>other</em>, converted to a <a>time
-              value</a> relative to this timeline's <a>zero time</a>.
-            </p>
-            <p>
-              Returns <code>null</code> if:
-            </p>
-            <ul>
-              <li>this timeline is <a>not started</a>, or</li>
-              <li><em>other</em> is <a>not started</a>.</li>
-            </ul>
-            <p>
-              Note that unlike <code>currentTime</code>, this method may return
-              a negative <a>time value</a> if <em>otherTime</em> occurred prior
-              to this timeline's <a>zero time</a>.
-            </p>
-            <p>
-              Furthermore, negative values for <em>otherTime</em> are also
-              allowed.
-            </p>
-            <p>
-              If this timeline records the <a>time value</a> of the <a>global
-              clock</a> at its <a>zero time</a> as <var>global clock
-              offset</var>, and so does <em>other</em> as <var>other global
-              clock offset</var>, then the result of this method is simply:
-            </p>
-            <blockquote>
-              <code><var>other global clock offset</var> + <var>otherTime</var>
-              - <var>global clock offset</var></code>
-            </blockquote>
-            <p>
-              Exceptions:
-            </p>
-            <dl class="exceptions">
-              <dt>DOMException of type <code>InvalidNodeTypeError</code></dt>
-              <dd>
-                Raised if <em>other</em> is a timeline that is not tied to the
-                <a>global clock</a>.
-                <p class="annotation">
-                  The reason for choosing <code>InvalidNodeTypeError</code> here
-                  is that DOM4 describes it as meaning, "The supplied node is
-                  incorrect or has an incorrect ancestor for this operation."
-                  In this case the error is because <em>other</em> does not have
-                  the <a>global clock</a> as an ancestor so it seems
-                  appropriate.
-                </p>
-              </dd>
-            </dl>
-          </dd>
-          <dt>double? toTimelineTime (Event event)</dt>
-          <dd>
-            <p>
-              Returns the number of milliseconds between when <em>event</em> was
-              fired and this <a>timeline</a>'s <a>zero time</a>.
-            </p>
-            <p>
-              Since the <code>timeStamp</code> attribute of the
-              <code>Event</code> interface specified in [[DOM-LEVEL-3-EVENTS]]
-              is not guaranteed to be monotonically increasing, implementations
-              SHOULD record alongside each event the <a>time value</a> of the
-              <a>global clock</a> when the event is dispatched so that it can be
-              converted to an accurate <a>time value</a> here.
-            </p>
-            <p>
-              Unlike <code>currentTime</code>, this method may return a negative
-              <a>time value</a> if the event was fired prior to this
-              <a>timeline</a>'s <a>zero time</a>.
-            </p>
-            <p>
-              Returns <code>null</code> if this <a>timeline</a> is <a>not
-              started</a>.
-            </p>
-            <p class="issue">
-              This might be deferred to a later version.
-            </p>
-          </dd>
         </dl>
       </section>
       <section>
@@ -8290,6 +8209,8 @@ <h2>Changes since last publication</h2>
         <li>Removed custom effect priorities.
         <li>Renamed the <code>Timeline</code> interface to
             <a>AnimationTimeline</a>.
+        <li>Removed both versions of <code>toTimelineTime</code> from the
+            <a>AnimationTimeline</a> interface.
         <li>Renamed <code>getCurrentPlayers</code> on the
             <a>AnimationTimeline</a> interface to
             <code>getAnimationPlayers</code>.