Skip to content
This repository was archived by the owner on Jul 9, 2024. It is now read-only.

Commit 9460989

Browse files
Reword altitudeAngle/azimuthAngle descriptions in line with PE, add illustrations (#125)
1 parent 550bcc0 commit 9460989

File tree

6 files changed

+24
-11
lines changed

6 files changed

+24
-11
lines changed

images/altitudeAngle.png

149 KB
Loading

images/azimuthAngle.png

154 KB
Loading
1020 KB
Binary file not shown.

images/sources/altitude-azimuth.skp

2.02 MB
Binary file not shown.

images/sources/azimuth-altitude.png

335 KB
Loading

index.html

Lines changed: 24 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -392,20 +392,33 @@ <h2><dfn>Touch</dfn> Interface</h2>
392392
</dd>
393393
<dt><dfn>altitudeAngle</dfn></dt>
394394
<dd>
395-
<p>The altitude (in radians) of a stylus, in the range <code>0</code>
396-
(parallel to the surface) to <code>&pi;/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>
399408
</dd>
400409
<dt><dfn>azimuthAngle</dfn></dt>
401410
<dd>
402-
<p>The azimuth angle (in radians) of a stylus, in the range <code>0</code>
403-
to <code>2&pi;</code>. <code>0</code> represents a stylus whose cap is
404-
pointing in the direction of increasing screenX values.
405-
<code>&pi;/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>
409422
</dd>
410423
<dt><dfn>touchType</dfn></dt>
411424
<dd>

0 commit comments

Comments
 (0)