added identifier algorithm; added glossary; added timestamp to TouchPoint
authorshepazu <schepers@w3.org>
Fri, 28 Jan 2011 22:23:44 -0500
changeset 10 bad00fb0d663
parent 9 8171bbe11ccc
child 11 c799fd07301e
added identifier algorithm; added glossary; added timestamp to TouchPoint
touchevents.html
--- a/touchevents.html	Fri Jan 28 22:13:56 2011 -0500
+++ b/touchevents.html	Fri Jan 28 22:23:44 2011 -0500
@@ -101,12 +101,25 @@
       <dl title='interface TouchPoint' class='idl'>
         <dt>readonly attribute long identifier</dt>
         <dd>
-          an identification number unique to each touch point, per session
+          An identification number for each touch point, unique to that touch point per session.
+          
+          <p>The algorithm for determining the <a>identifier</a> value is as follows:</p>
+          <ol>
+            <li>if there are no other <a>active touch event session</a>s, the value of <a>identifier</a> must be <code>0</code></li>
+            <li>if there is at least one <a>active touch event session</a>, the value of <a>identifier</a> must be the lowest integer not currently used by any active <a>TouchPoint</a> object in any <a>active touch event session</a></li>
+          </ol> 
         </dd>
         <dt>readonly attribute EventTarget target</dt>
         <dd>
           the original proximal event target for this touch point 
         </dd>
+        <dt>readonly attribute DOMTimeStamp timestamp</dt>
+        <dd>
+          The <a>timestamp</a> attribute represents the time when the <a>TouchPoint</a> was initiated and is represented as a DOMTimeStamp [[!DOM-LEVEL-3-CORE]].
+          <p class="issue" id="issue-timestamp-format"><strong>Issue:</strong> should we align to timestamp as defined in the <a href="http://dev.w3.org/geo/api/#timestamp">Geolocation API spec</a> (as above), or with the datetime as defined in the <a href="http://dev.w3.org/html5/spec/edits.html#attr-mod-datetime">HTML5 spec</a> (attribute DOMString dateTime, where datetime is a <a href="http://dev.w3.org/html5/spec/common-microsyntaxes.html#valid-global-date-and-time-string">valid global date and time string</a>), or to something else (see <a href="http://lists.w3.org/Archives/Public/www-dom/2010OctDec/0069.html">this thread on Event.timeStamp</a>)?</p>
+      
+          <p class="issue" id="issue-timestamp"><strong>Issue:</strong> Should each touchpoint have its own timestamp?  Or should we leave timestamps up to script authors?  My feeling is that having implicit timestamps may be useful in defining an author-defined gesture-like mapping between low-level and high-level events (e.g. a swipe vs. drag speed threshold expressed as the difference in timestamps)</p>
+        </dd>        
 
         <dt>readonly attribute long screenX</dt>
         <dd>
@@ -138,6 +151,7 @@
         <dt>readonly attribute long radiusX</dt>
         <dd>
           the radius of the ellipse which most closely circumscribes the touching area (e.g. finger, stylus) along the x-axis, in pixels of the same scale as <a>screenX</a>; <code>1</code> if no value is known.  This attribute may not be available on all user agents or platforms.
+          <p class="issue" id="issue-units"><strong>Issue:</strong> What are units of radiusX/radiusY?  CSS Pixels?</p>
         </dd>
         <dt>readonly attribute long radiusY</dt>
         <dd>
@@ -147,6 +161,8 @@
         <dt>readonly attribute float force</dt>
         <dd>
           a relative value of pressure applied, in the range <code>0</code> to <code>1</code>, where <code>0</code> is no pressure, and <code>1</code> is the highest level of pressure the touch device is capable of sensing; <code>0</code> if no value is known.  This attribute may not be available on all user agents or platforms.  In environments where <a>force</a> is available, the absolute pressure represented by the <a>force</a> attribute, and the sensitivity in levels of pressure, may vary.
+
+          <p class="issue" id="issue-inkml"><strong>Issue:</strong> Consider aligning with other "channels" and values from <a href="http://www.w3.org/TR/InkML/#channelContents">Ink Markup Language (InkML)</a>, in addition to <a>force</a>, e.g. adding <a>angle</a>, <a>clientZ</a>, <a>rotation</a>, etc.</p>
         </dd>
 
         <dt>readonly attribute boolean altKey</dt>
@@ -163,11 +179,6 @@
         </dd>
       </dl>
       
-      <p class="issue" id="issue-inkml"><strong>Issue:</strong> Consider aligning with "channels" and values from <a href="http://www.w3.org/TR/InkML/#channelContents">Ink Markup Language (InkML)</a>.</p>
-      
-      <p class="issue" id="issue-timestamp"><strong>Issue:</strong> Should each touchpoint have its own timestamp?</p>
-
-      <p class="issue" id="issue-units"><strong>Issue:</strong> What are units of radiusX/radiusY?  CSS Pixels?</p>
     </section>
 
     
@@ -249,6 +260,21 @@
       </section>
     </section>
     
+    <section>
+      <h2>Glossary</h2>
+      
+      <dl>
+        <dt><dfn>active touch event session</dfn></dt>
+        <dd>A conceptual state in which there is at least one instance of a <a>TouchEvent</a> event with at least one non-empty <a>TouchList</a>.
+          <!-- <pre class='example'>
+            
+          </pre> -->
+        </dd>
+        
+      </dl>
+      
+    </section>
+    
     <section class='appendix'>
       <h2>Acknowledgements</h2>
       <p>