@@ -392,20 +392,33 @@ <h2><dfn>Touch</dfn> Interface</h2>
392
392
</ dd >
393
393
< dt > < dfn > altitudeAngle</ dfn > </ dt >
394
394
< dd >
395
- < p > The altitude (in radians) of a stylus, in the range < code > 0</ code >
396
- (parallel to the surface) to < code > π/2</ code > (perpendicular to the
397
- surface). The value < code > 0</ code > should be used for devices which
398
- do not support this property.</ p >
395
+ < p > The altitude (in radians) of the transducer (e.g. pen/stylus), in the range [0,π/2]
396
+ — where 0 is parallel to the surface (X-Y plane), and π/2 is perpendicular to the surface.
397
+ For hardware and platforms that do not report tilt or angle, the value MUST be 0.</ p >
398
+ < div class ="note ">
399
+ The default value defined here for < code > altitudeAngle</ code > is 0.
400
+ This differs from the < a href ="https://w3c.github.io/pointerevents/ "> Pointer Events - Level 3</ a > [[POINTEREVENTS]] specification's
401
+ definition for the < code > altitudeAngle</ code > property, which has a default value of π/2,
402
+ which positions the transducer as being perpendicular to the surface.
403
+ </ div >
404
+ < figure id ="figure_altitudeAngle ">
405
+ < img src ="images/altitudeAngle.png " alt ="altitudeAngle explanation diagram ">
406
+ < figcaption > Example < code > altitudeAngle</ code > of π/4 (45 degrees from the X-Y plane).</ figcaption >
407
+ </ figure >
399
408
</ dd >
400
409
< dt > < dfn > azimuthAngle</ dfn > </ dt >
401
410
< dd >
402
- < p > The azimuth angle (in radians) of a stylus, in the range < code > 0</ code >
403
- to < code > 2π</ code > . < code > 0</ code > represents a stylus whose cap is
404
- pointing in the direction of increasing screenX values.
405
- < code > π/2</ code > represents a stylus whose cap is pointing in the
406
- direction of increasing screenY values.
407
- The value < code > 0</ code > should be used for devices which
408
- do not support this property.</ p >
411
+ < p > The azimuth angle (in radians) of the transducer (e.g. pen/stylus),
412
+ in the range [0, 2π] — where 0 represents a transducer whose cap is pointing in the
413
+ direction of increasing X values (point to "3 o'clock" if looking straight down) on the X-Y plane,
414
+ and the values progressively increase when going clockwise
415
+ (π/2 at "6 o'clock", π at "9 o'clock", 3π/2 at "12 o'clock").
416
+ When the transducer is perfectly perpendicular to the surface (< code > altitudeAngle</ code > of π/2), the value MUST be 0.
417
+ For hardware and platforms that do not report tilt or angle, the value should be 0.</ p >
418
+ < figure id ="figure_azimuthAngle ">
419
+ < img src ="images/azimuthAngle.png " alt ="azimuthAngle explanation diagram ">
420
+ < figcaption > Example < code > azimuthAngle</ code > of π/6 ("4 o'clock").</ figcaption >
421
+ </ figure >
409
422
</ dd >
410
423
< dt > < dfn > touchType</ dfn > </ dt >
411
424
< dd >
0 commit comments