Remove player events

Author: birtles

web-animations/index.html

@@ -368,14 +368,8 @@ <h3>Stateless</h3>
           of the core timing model but are layered on top.
         </p>
         <p>
-          Likewise, <a>player events</a> are fired when the first sample occurs
-          at the limit of the <a>source content</a>.
-          This too is stative behavior but is part of the play control layered
-          on top of the timing model.
-        </p>
-        <p>
-          Similarly, the <a href="#limiting-the-current-time">limiting
-          behavior</a> of players means that dynamic changes to the end time of
+          Similarly, the <a href="#reaching-the-end">limiting behavior</a> of
+          players means that dynamic changes to the end time of
           the media (source content) of a player may produce a different result
           depending on when the change occurs.
           This behavior is somewhat unfortunate but has been deemed intuitive
@@ -598,8 +592,8 @@ <h2>Players</h2>
         When a <a>player</a> is created, it is assigned a globally unique
         sequence number called the <dfn>player sequence number</dfn>.
         This number is used to resolve the sort order of players for a variety
-        of situations such as combining animations, queuing events, and
-        returning the list of current players.
+        of situations such as combining animations and returning the list of
+        current players.
       </p>
       <p class="issue">
         Should this actually be based on when the player is attached to
@@ -1403,102 +1397,6 @@ <h3>Player state</h3>
           </pre>
         </div>
       </section>
-      <section>
-        <h2>Player events</h2>
-        <p>
-          As <a>players</a> play they report changes to
-          their status through <dfn title="player event">player events</dfn>.
-        </p>
-        <p>
-          <a>Player events</a> are a property of the Web Animations timing
-          model.
-          As a result they are dispatched even when the <a>source content</a> of
-          the player is absent or has no observable result.
-        </p>
-        <section>
-          <h3>Types of player events</h3>
-            <dl>
-            <dt><dfn title="finish player event">finish</dfn></dt>
-            <dd>
-              <p>
-                Queued whenever a sample occurs that causes a <a>player</a>'s
-                <a>finished flag</a> to be newly true.
-              </p>
-              <ul>
-                <li>Bubbles: no</li>
-                <li>Cancelable: no</li>
-                <li>Context Info: currentTime, documentTime</li>
-              </ul>
-            </dd>
-          </dl>
-          <p>
-            To assist dispatching <a title="finish player event">finish
-            events</a>, <a>players</a> maintain a <dfn>finished flag</dfn> that
-            is initially false when the player is created.
-          </p>
-          <p>
-            During each <a>sample</a>, the <a>finished flag</a> is updated such
-            that it is set to true if the player is <a>limited</a> and false
-            otherwise.
-          </p>
-        </section>
-        <section>
-          <h3>Event parameters</h3>
-          <p>
-            <a>Player events</a> have an associated <a>event
-            current time</a> and <a>event timeline time</a>.
-          </p>
-          <p>
-            The <dfn>event current time</dfn> is the <a>current time</a> of the
-            <a>player</a> that generated the event at the moment the event is
-            queued.
-            This will be null if the <a>player</a> was not associated with
-            a <a>timeline</a> at the time the event was generated.
-          </p>
-          <p>
-            The <dfn>event timeline time</dfn> is the <a>time value</a> of the
-            <a>timeline</a> with which the <a>player</a> that generated the
-            event is associated at the moment the event is queued.
-            This will be null if the <a>player</a> was not associated with
-            a <a>timeline</a> at the time the event was generated.
-          </p>
-        </section>
-        <section>
-          <h3>Propagation path</h3>
-          <p>
-            The <a
-            href="http://www.w3.org/TR/DOM-Level-3-Events/#glossary-propagation-path">propagation
-            path</a> for a <a>player event</a> generated by <var>player</var>,
-            is simply <var>player</var> itself.
-          </p>
-        </section>
-        <section>
-          <h3>Sequence of events</h3>
-          <p>
-            The sequence in which <a>player events</a> are queued is in
-            ascending order by <a>event timeline time</a>.
-            If two <a>player events</a> have the same <a>event document
-            time</a>, the <a>player events</a> are queued in ascending order by
-            <a>player sequence number</a> of the <a>players</a> that generated
-            the events.
-          </p>
-        </section>
-        <section>
-          <h3>Event dispatch</h3>
-          <p>
-            <dfn>Events are queued</dfn> whenever <a>sampling</a> regularly
-            occurs (that is, <em>not</em> when the timing model is evaluated due
-            to <a>seeking</a> or structural changes to the hierarchy of
-            <a>animation nodes</a>).
-          </p>
-          <p>
-            As a result, <a>seeking</a> a <a>player</a> to the limit of its
-            <a>source content</a> and back to a point within its <a>source
-            content</a> within the same script execution block will <em>not</em>
-            trigger a <a title="finish player event">finish</a> event.
-          </p>
-        </section>
-      </section>
     </section>
 
     <section>
@@ -3719,8 +3617,8 @@ <h4>Not animatable</h4>
             An <a>animation effect</a> that targets a property that is
             <a>not animatable</a> will still exhibit the usual behavior for
             an <a>animation node</a> such as occupying time in an <a>animation
-            sequence</a> and delaying the firing of a <a>player</a>'s <a
-            title="finish player event">finish event</a>.
+            sequence</a> and delaying the fulfilment of a <a>player</a>'s
+            <a>current finished promise</a>
           </p>
         </section>
         <section>
@@ -5715,7 +5613,7 @@ <h3>The <code>AnimationPlayer</code> interface</h3>
           <a>Players</a> are represented in the Web Animations
           API by the <a>AnimationPlayer</a> interface.
         </p>
-        <dl title="interface AnimationPlayer : EventTarget" class="idl">
+        <dl title="interface AnimationPlayer" class="idl">
           <dt>attribute AnimationNode? source</dt>
           <dd>
             <p>
@@ -5829,19 +5727,6 @@ <h3>The <code>AnimationPlayer</code> interface</h3>
             it has finished playing in the reversed direction by running the
             <a>reverse a player</a> procedure for this object.
           </dd>
-          <dt>// Event callbacks</dt><dd></dd>
-          <dt>attribute EventHandler onfinish</dt>
-          <dd>
-            <p>
-              The event handler for the <a
-                title="finish player event">finish</a> event.
-            </p>
-            <p class="note">
-              Note that the <a
-              href="http://www.w3.org/TR/html5/webappapis.html#eventhandler">EventHandler</a>
-              callback interface type is defined in [[!HTML5]].
-            </p>
-          </dd>
         </dl>
         <section>
           <h3>The <code>AnimationPlayState</code> enumeration</h3>
@@ -7991,52 +7876,6 @@ <h3>The <code>EffectCallback</code> callback function</h3>
           </dl>
         </div>
       </section>
-      <section>
-        <h3>The <code>AnimationPlayerEvent</code> interface</h3>
-        <p>
-          <a>Player events</a> are represented in the API by the
-          <a>AnimationPlayerEvent</a> interface.
-        </p>
-        <dl title="interface AnimationPlayerEvent : Event" class="idl">
-          <dt>Constructor ()</dt>
-          <dd>
-            Constructs a new <a>AnimationPlayerEvent</a> object as described in
-            <a href="http://www.w3.org/TR/dom/#constructing-events">Constructing
-            events</a> in [[!DOM4]].
-            <dl class="parameters">
-              <dt>DOMString type</dt>
-              <dd>
-                The type of <a>player event</a> corresponding to one of the
-                types defined in <a href="#types-of-player-events"
-                class="sectionRef"></a>.
-              </dd>
-              <dt>optional AnimationPlayerEventInit eventInit</dt>
-              <dd>
-                The parameters of the new <a>AnimationPlayerEvent</a>.
-              </dd>
-            </dl>
-          </dd>
-          <dt>attribute double? currentTime</dt>
-          <dd>
-            The <a>event current time</a>.
-          </dd>
-          <dt>attribute double? timelineTime</dt>
-          <dd>
-            The <a>event timeline time</a>.
-          </dd>
-        </dl>
-        <p>
-          The <a>AnimationPlayerEventInit</a> dictionary type is used to specify
-          the parameters when constructing an <a>AnimationPlayerEvent</a>
-          object.
-        </p>
-        <dl title="dictionary AnimationPlayerEventInit" class="idl">
-          <dt>double? currentTime = null</dt>
-          <dd></dd>
-          <dt>double? timelineTime = null</dt>
-          <dd></dd>
-        </dl>
-      </section>
       <section>
         <h3>Extensions to the <code>Document</code> interface</h3>
         <p>
@@ -8355,9 +8194,7 @@ <h3>Conformance criteria</h3>
           A <dfn>conforming scripted Web Animations user agent</dfn> is a user
           agent that implements the <abbr
           title="Application Programming Interface">API</abbr> defined in <a
-          href="#programming-interface" class="sectionRef"></a> including
-          dispatching events as defined in <a href="#player-events"
-          class="sectionRef"></a>.
+          href="#programming-interface" class="sectionRef"></a>.
         </p>
       </section>
     </section>