bug 17306, bug 21322 - clarify definition of timestamp
authorTed Mielczarek <ted@mielczarek.org>
Fri, 22 Mar 2013 10:21:33 -0400
changeset 1927b047265c4d
parent 18 a2c5e56138f4
child 20 2d5e28445938
bug 17306, bug 21322 - clarify definition of timestamp
gamepad.html
     1.1 --- a/gamepad.html	Fri Mar 22 08:14:41 2013 -0400
     1.2 +++ b/gamepad.html	Fri Mar 22 10:21:33 2013 -0400
     1.3 @@ -124,7 +124,8 @@
     1.4        <ul>
     1.5        <li><a class="externalDFN">Navigator</a> [[!NAVIGATOR]]</li>
     1.6        <li><a class="externalDFN">DOMHighResTimeStamp</a> [[!HIGHRES-TIME]]</li>
     1.7 -      <li><a class="externalDFN">WindowAnimationTiming</a></li>
     1.8 +      <li><a class="externalDFN">WindowAnimationTiming [[!ANIMATION-TIMING]]</a></li>
     1.9 +      <li><a class="externalDFN">PerformanceTiming [[!NAVIGATION-TIMING]]</a></li>
    1.10        </ul>
    1.11  
    1.12      </section>
    1.13 @@ -226,11 +227,16 @@
    1.14  
    1.15            Timestamp is a monotonically increasing value that allows the author
    1.16            to determine if the <code>axes</code> and <code>button</code> data
    1.17 -          have been updated from the hardware, relative to a previously saved
    1.18 -          timestamp. The time is relative to the navigationStart of attribute
    1.19 -          of the PerformanceTiming interface (that is, fractional milliseconds
    1.20 -          since page load).
    1.21 +          have been updated from the hardware. The value must be relative to
    1.22 +          the <code>navigationStart</code> attribute of the PerformanceTiming
    1.23 +          interface. Since values are monotonically increasing they can be
    1.24 +          compared to determine the ordering of updates, as newer values will
    1.25 +          always be greater than or equal to older values.
    1.26  
    1.27 +          If no data has been received from the hardware, the value of
    1.28 +          the <code>timestamp</code> attribute should be the time relative
    1.29 +          to <code>navigationStart</code> when the Gamepad object was first
    1.30 +          made available to script.
    1.31          </dd>
    1.32  
    1.33          <dt>readonly attribute double[] axes</dt>