Skip to content

Commit

Permalink
Merge pull request #1395 from cabanier/pen-ray
Browse files Browse the repository at this point in the history 
SHA: 889804d
Reason: push, by cabanier

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
  • Loading branch information
@cabanier @github-actions
cabanier and github-actions[bot] committed Sep 27, 2024
1 parent fc84e00 commit e4dd58a
Showing 1 changed file with 5 additions and 5 deletions.
10 changes: 5 additions & 5 deletions index.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@
<link href="https://www.w3.org/StyleSheets/TR/2021/W3C-CR" rel="stylesheet">
<meta content="Bikeshed version 82ce88815, updated Thu Sep 7 16:33:55 2023 -0700" name="generator">
<link href="https://www.w3.org/TR/webxr/" rel="canonical">
<meta content="08eb183502b6f93303e39b1cbaa1475e9bbe836f" name="document-revision">
<meta content="889804df228d353770f997a9b72cf018b400f7da" name="document-revision">
<link href="favicon-32x32.png" rel="icon" sizes="32x32" type="image/png">
<link href="favicon-96x96.png" rel="icon" sizes="96x96" type="image/png">
<style>
Expand Down Expand Up @@ -2825,7 +2825,7 @@ <h3 class="heading settled" data-level="10.1" id="xrinputsource-interface"><span
<li data-md>
<p><dfn class="dfn-paneled idl-code" data-dfn-for="XRTargetRayMode" data-dfn-type="enum-value" data-export data-lt="&quot;gaze&quot;|gaze" id="dom-xrtargetraymode-gaze"><code>gaze</code></dfn> indicates the target ray will originate at the viewer and follow the direction it is facing. (This is commonly referred to as a "gaze input" device in the context of head-mounted displays.)</p>
<li data-md>
<p><dfn class="dfn-paneled idl-code" data-dfn-for="XRTargetRayMode" data-dfn-type="enum-value" data-export data-lt="&quot;tracked-pointer&quot;|tracked-pointer" id="dom-xrtargetraymode-tracked-pointer"><code>tracked-pointer</code></dfn> indicates that the target ray originates from either a handheld device or other hand-tracking mechanism and represents that the user is using their hands or the held device for pointing. The orientation of the target ray relative to the tracked object MUST follow platform-specific ergonomics guidelines when available. In the absence of platform-specific guidance, the target ray SHOULD point in the same direction as the user’s index finger if it was outstretched.</p>
<p><dfn class="dfn-paneled idl-code" data-dfn-for="XRTargetRayMode" data-dfn-type="enum-value" data-export data-lt="&quot;tracked-pointer&quot;|tracked-pointer" id="dom-xrtargetraymode-tracked-pointer"><code>tracked-pointer</code></dfn> indicates that the target ray originates from either a handheld device or other hand-tracking mechanism and represents that the user is using their hands or the held device for pointing. The orientation of the target ray relative to the tracked object MUST follow platform-specific ergonomics guidelines when available. In the absence of platform-specific guidance, the target ray SHOULD point in the same direction as the user’s index finger if it was outstretched. If the <code class="idl"><a data-link-type="idl" href="#xrsystem" id="ref-for-xrsystem①⑧">XRSystem</a></code> determines that part of the handheld device is or becomes intended to contact real-world surfaces (such as a pen tip), the target ray MUST originate at that point.</p>
<li data-md>
<p><dfn class="dfn-paneled idl-code" data-dfn-for="XRTargetRayMode" data-dfn-type="enum-value" data-export data-lt="&quot;screen&quot;|screen" id="dom-xrtargetraymode-screen"><code>screen</code></dfn> indicates that the input source was an interaction with the canvas element associated with an inline session’s output context, such as a mouse click or touch event.</p>
<li data-md>
Expand Down Expand Up @@ -3445,11 +3445,11 @@ <h3 class="heading settled" data-level="12.4" id="xrreferencespaceevent-interfac
};
</pre>
<p>The <dfn class="dfn-paneled idl-code" data-dfn-for="XRReferenceSpaceEvent" data-dfn-type="attribute" data-export id="dom-xrreferencespaceevent-referencespace"><code>referenceSpace</code></dfn> attribute indicates the <code class="idl"><a data-link-type="idl" href="#xrreferencespace" id="ref-for-xrreferencespace③②">XRReferenceSpace</a></code> that generated this event.</p>
<p>The optional <dfn class="dfn-paneled idl-code" data-dfn-for="XRReferenceSpaceEvent" data-dfn-type="attribute" data-export id="dom-xrreferencespaceevent-transform"><code>transform</code></dfn> attribute describes the post-event position and orientation of the <code class="idl"><a data-link-type="idl" href="#dom-xrreferencespaceevent-referencespace" id="ref-for-dom-xrreferencespaceevent-referencespace①">referenceSpace</a></code>'s <a data-link-type="dfn" href="#xrspace-native-origin" id="ref-for-xrspace-native-origin①⑦">native origin</a> in the pre-event coordinate system. This attribute MAY be <code>null</code> if the <code class="idl"><a data-link-type="idl" href="#xrsystem" id="ref-for-xrsystem①⑧">XRSystem</a></code> can’t determine the delta between the old and the new coordinate system.</p>
<p>The optional <dfn class="dfn-paneled idl-code" data-dfn-for="XRReferenceSpaceEvent" data-dfn-type="attribute" data-export id="dom-xrreferencespaceevent-transform"><code>transform</code></dfn> attribute describes the post-event position and orientation of the <code class="idl"><a data-link-type="idl" href="#dom-xrreferencespaceevent-referencespace" id="ref-for-dom-xrreferencespaceevent-referencespace①">referenceSpace</a></code>'s <a data-link-type="dfn" href="#xrspace-native-origin" id="ref-for-xrspace-native-origin①⑦">native origin</a> in the pre-event coordinate system. This attribute MAY be <code>null</code> if the <code class="idl"><a data-link-type="idl" href="#xrsystem" id="ref-for-xrsystem①⑨">XRSystem</a></code> can’t determine the delta between the old and the new coordinate system.</p>
<p class="note" role="note"><span class="marker">NOTE:</span> situations where <code class="idl"><a data-link-type="idl" href="#dom-xrreferencespaceevent-referencespace" id="ref-for-dom-xrreferencespaceevent-referencespace②">referenceSpace</a></code> or <code class="idl"><a data-link-type="idl" href="#dom-xrreferencespaceeventinit-referencespace" id="ref-for-dom-xrreferencespaceeventinit-referencespace">referenceSpace</a></code> can be when the headset was doffed and donned between 2 seperate locations. In such cases, if the experience relies on world-locked content, it should warn the user and reset the scene.</p>
<h3 class="heading settled" data-level="12.5" id="event-types"><span class="secno">12.5. </span><span class="content">Event Types</span><a class="self-link" href="#event-types"></a></h3>
<p>The user agent MUST provide the following new events. Registration for and firing of the events must follow the usual behavior of DOM Events.</p>
<p>The user agent MUST <a data-link-type="dfn" href="https://dom.spec.whatwg.org/#concept-event-fire" id="ref-for-concept-event-fire①">fire an event</a> named <dfn class="dfn-paneled idl-code" data-dfn-for="XRSystem" data-dfn-type="event" data-export id="eventdef-xrsystem-devicechange"><code>devicechange</code></dfn> event on the <code class="idl"><a data-link-type="idl" href="#xrsystem" id="ref-for-xrsystem①⑨">XRSystem</a></code> object to indicate that the availability of <a data-link-type="dfn" href="#immersive-xr-device" id="ref-for-immersive-xr-device③②">immersive XR device</a>s has been changed unless the document’s <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/origin.html#concept-origin" id="ref-for-concept-origin③">origin</a> is not allowed to use the "xr-spatial-tracking" <a href="#permissions-policy">permissions policy</a>.</p>
<p>The user agent MUST <a data-link-type="dfn" href="https://dom.spec.whatwg.org/#concept-event-fire" id="ref-for-concept-event-fire①">fire an event</a> named <dfn class="dfn-paneled idl-code" data-dfn-for="XRSystem" data-dfn-type="event" data-export id="eventdef-xrsystem-devicechange"><code>devicechange</code></dfn> event on the <code class="idl"><a data-link-type="idl" href="#xrsystem" id="ref-for-xrsystem②⓪">XRSystem</a></code> object to indicate that the availability of <a data-link-type="dfn" href="#immersive-xr-device" id="ref-for-immersive-xr-device③②">immersive XR device</a>s has been changed unless the document’s <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/origin.html#concept-origin" id="ref-for-concept-origin③">origin</a> is not allowed to use the "xr-spatial-tracking" <a href="#permissions-policy">permissions policy</a>.</p>
<p>A user agent MUST <a data-link-type="dfn" href="https://dom.spec.whatwg.org/#concept-event-fire" id="ref-for-concept-event-fire②">fire an event</a> named <dfn class="dfn-paneled idl-code" data-dfn-for="XRSession" data-dfn-type="event" data-export id="eventdef-xrsession-visibilitychange"><code>visibilitychange</code></dfn> using <code class="idl"><a data-link-type="idl" href="#xrsessionevent" id="ref-for-xrsessionevent③">XRSessionEvent</a></code> on an <code class="idl"><a data-link-type="idl" href="#xrsession" id="ref-for-xrsession①③⑦">XRSession</a></code> each time the <a data-link-type="dfn" href="#xrsession-visibility-state" id="ref-for-xrsession-visibility-state⑨">visibility state</a> of the <code class="idl"><a data-link-type="idl" href="#xrsession" id="ref-for-xrsession①③⑧">XRSession</a></code> has changed.</p>
<p>A user agent MUST <a data-link-type="dfn" href="https://dom.spec.whatwg.org/#concept-event-fire" id="ref-for-concept-event-fire③">fire an event</a> named <dfn class="dfn-paneled idl-code" data-dfn-for="XRSession" data-dfn-type="event" data-export id="eventdef-xrsession-end"><code>end</code></dfn> using <code class="idl"><a data-link-type="idl" href="#xrsessionevent" id="ref-for-xrsessionevent④">XRSessionEvent</a></code> on an <code class="idl"><a data-link-type="idl" href="#xrsession" id="ref-for-xrsession①③⑨">XRSession</a></code> when the session ends, either by the application or the user agent.</p>
<p>A user agent MUST <a data-link-type="dfn" href="https://dom.spec.whatwg.org/#concept-event-fire" id="ref-for-concept-event-fire④">fire an event</a> named <dfn class="dfn-paneled idl-code" data-dfn-for="XRSession" data-dfn-type="event" data-export id="eventdef-xrsession-inputsourceschange"><code>inputsourceschange</code></dfn> using <code class="idl"><a data-link-type="idl" href="#xrinputsourceschangeevent" id="ref-for-xrinputsourceschangeevent⑤">XRInputSourcesChangeEvent</a></code> on an <code class="idl"><a data-link-type="idl" href="#xrsession" id="ref-for-xrsession①④⓪">XRSession</a></code> when the session’s <a data-link-type="dfn" href="#list-of-active-xr-input-sources" id="ref-for-list-of-active-xr-input-sources①②">list of active XR input sources</a> has changed.</p>
Expand Down Expand Up @@ -7601,7 +7601,7 @@ <h2 class="no-num no-ref heading settled" id="idl-index"><span class="content">I
window.dfnpanelData['default-inline-xr-device'] = {"dfnID": "default-inline-xr-device", "url": "#default-inline-xr-device", "dfnText": "default inline XR device", "refSections": [{"refs": [{"id": "ref-for-default-inline-xr-device"}, {"id": "ref-for-default-inline-xr-device\u2460"}, {"id": "ref-for-default-inline-xr-device\u2461"}, {"id": "ref-for-default-inline-xr-device\u2462"}, {"id": "ref-for-default-inline-xr-device\u2463"}, {"id": "ref-for-default-inline-xr-device\u2464"}], "title": "2.1. XR device"}, {"refs": [{"id": "ref-for-default-inline-xr-device\u2465"}, {"id": "ref-for-default-inline-xr-device\u2466"}], "title": "3.2. XRSystem"}], "external": false};
window.dfnpanelData['inline-xr-device'] = {"dfnID": "inline-xr-device", "url": "#inline-xr-device", "dfnText": "inline XR device", "refSections": [{"refs": [{"id": "ref-for-inline-xr-device"}, {"id": "ref-for-inline-xr-device\u2460"}, {"id": "ref-for-inline-xr-device\u2461"}, {"id": "ref-for-inline-xr-device\u2462"}, {"id": "ref-for-inline-xr-device\u2463"}], "title": "2.1. XR device"}, {"refs": [{"id": "ref-for-inline-xr-device\u2464"}, {"id": "ref-for-inline-xr-device\u2465"}, {"id": "ref-for-inline-xr-device\u2466"}], "title": "3.2. XRSystem"}], "external": false};
window.dfnpanelData['dom-navigator-xr'] = {"dfnID": "dom-navigator-xr", "url": "#dom-navigator-xr", "dfnText": "xr", "refSections": [{"refs": [{"id": "ref-for-dom-navigator-xr"}], "title": "3.1. navigator.xr"}, {"refs": [{"id": "ref-for-dom-navigator-xr\u2460"}], "title": "3.2. XRSystem"}, {"refs": [{"id": "ref-for-dom-navigator-xr\u2461"}], "title": "14.1. Permissions Policy"}], "external": false};
window.dfnpanelData['xrsystem'] = {"dfnID": "xrsystem", "url": "#xrsystem", "dfnText": "XRSystem", "refSections": [{"refs": [{"id": "ref-for-xrsystem"}, {"id": "ref-for-xrsystem\u2460"}], "title": "3.1. navigator.xr"}, {"refs": [{"id": "ref-for-xrsystem\u2461"}, {"id": "ref-for-xrsystem\u2462"}, {"id": "ref-for-xrsystem\u2463"}, {"id": "ref-for-xrsystem\u2464"}, {"id": "ref-for-xrsystem\u2465"}, {"id": "ref-for-xrsystem\u2466"}, {"id": "ref-for-xrsystem\u2467"}], "title": "3.2. XRSystem"}, {"refs": [{"id": "ref-for-xrsystem\u2468"}, {"id": "ref-for-xrsystem\u2460\u24ea"}, {"id": "ref-for-xrsystem\u2460\u2460"}, {"id": "ref-for-xrsystem\u2460\u2461"}, {"id": "ref-for-xrsystem\u2460\u2462"}, {"id": "ref-for-xrsystem\u2460\u2463"}, {"id": "ref-for-xrsystem\u2460\u2464"}, {"id": "ref-for-xrsystem\u2460\u2465"}, {"id": "ref-for-xrsystem\u2460\u2466"}], "title": "4.1. XRSession"}, {"refs": [{"id": "ref-for-xrsystem\u2460\u2467"}], "title": "12.4. XRReferenceSpaceEvent"}, {"refs": [{"id": "ref-for-xrsystem\u2460\u2468"}], "title": "12.5. Event Types"}], "external": false};
window.dfnpanelData['xrsystem'] = {"dfnID": "xrsystem", "url": "#xrsystem", "dfnText": "XRSystem", "refSections": [{"refs": [{"id": "ref-for-xrsystem"}, {"id": "ref-for-xrsystem\u2460"}], "title": "3.1. navigator.xr"}, {"refs": [{"id": "ref-for-xrsystem\u2461"}, {"id": "ref-for-xrsystem\u2462"}, {"id": "ref-for-xrsystem\u2463"}, {"id": "ref-for-xrsystem\u2464"}, {"id": "ref-for-xrsystem\u2465"}, {"id": "ref-for-xrsystem\u2466"}, {"id": "ref-for-xrsystem\u2467"}], "title": "3.2. XRSystem"}, {"refs": [{"id": "ref-for-xrsystem\u2468"}, {"id": "ref-for-xrsystem\u2460\u24ea"}, {"id": "ref-for-xrsystem\u2460\u2460"}, {"id": "ref-for-xrsystem\u2460\u2461"}, {"id": "ref-for-xrsystem\u2460\u2462"}, {"id": "ref-for-xrsystem\u2460\u2463"}, {"id": "ref-for-xrsystem\u2460\u2464"}, {"id": "ref-for-xrsystem\u2460\u2465"}, {"id": "ref-for-xrsystem\u2460\u2466"}], "title": "4.1. XRSession"}, {"refs": [{"id": "ref-for-xrsystem\u2460\u2467"}], "title": "10.1. XRInputSource"}, {"refs": [{"id": "ref-for-xrsystem\u2460\u2468"}], "title": "12.4. XRReferenceSpaceEvent"}, {"refs": [{"id": "ref-for-xrsystem\u2461\u24ea"}], "title": "12.5. Event Types"}], "external": false};
window.dfnpanelData['enumerate-immersive-xr-devices'] = {"dfnID": "enumerate-immersive-xr-devices", "url": "#enumerate-immersive-xr-devices", "dfnText": "enumerate immersive XR devices", "refSections": [{"refs": [{"id": "ref-for-enumerate-immersive-xr-devices"}], "title": "3.2. XRSystem"}], "external": false};
window.dfnpanelData['select-an-immersive-xr-device'] = {"dfnID": "select-an-immersive-xr-device", "url": "#select-an-immersive-xr-device", "dfnText": "select an immersive XR device", "refSections": [{"refs": [{"id": "ref-for-select-an-immersive-xr-device"}, {"id": "ref-for-select-an-immersive-xr-device\u2460"}], "title": "3.2. XRSystem"}], "external": false};
window.dfnpanelData['ensure-an-immersive-xr-device-is-selected'] = {"dfnID": "ensure-an-immersive-xr-device-is-selected", "url": "#ensure-an-immersive-xr-device-is-selected", "dfnText": "ensure an immersive XR device is selected", "refSections": [{"refs": [{"id": "ref-for-ensure-an-immersive-xr-device-is-selected"}, {"id": "ref-for-ensure-an-immersive-xr-device-is-selected\u2460"}], "title": "3.2. XRSystem"}, {"refs": [{"id": "ref-for-ensure-an-immersive-xr-device-is-selected\u2461"}, {"id": "ref-for-ensure-an-immersive-xr-device-is-selected\u2462"}, {"id": "ref-for-ensure-an-immersive-xr-device-is-selected\u2463"}], "title": "11.3. WebGL Context Compatibility"}], "external": false};
Expand Down

0 comments on commit e4dd58a

Please sign in to comment.