From d876b67101b280bc9371f1ba5a4df734abdea13e Mon Sep 17 00:00:00 2001
From: Rik Cabanier <cabanier@fb.com>
Date: Mon, 22 Apr 2024 16:22:09 +0000
Subject: [PATCH] Merge pull request #306 from tidoust/redraw

SHA: 64a37a4eea3a6e0659ef912598042585a90cdbf3
Reason: push, by cabanier

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
---
 index.html | 22 +++++++++++-----------
 1 file changed, 11 insertions(+), 11 deletions(-)

diff --git a/index.html b/index.html
index d91fb2d..f26a2a3 100644
--- a/index.html
+++ b/index.html
@@ -7,7 +7,7 @@
   <link href="https://www.w3.org/StyleSheets/TR/2021/W3C-ED" 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/webxrlayers-1/" rel="canonical">
-  <meta content="6a896daee5b5faab13fa45384572e9f9fca77e1e" name="document-revision">
+  <meta content="64a37a4eea3a6e0659ef912598042585a90cdbf3" 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>
@@ -733,7 +733,7 @@
   <div class="head">
    <p data-fill-with="logo"><a class="logo" href="https://www.w3.org/"> <img alt="W3C" height="48" src="https://www.w3.org/StyleSheets/TR/2021/logos/W3C" width="72"> </a> </p>
    <h1 class="p-name no-ref" id="title">WebXR Layers API Level 1</h1>
-   <p id="w3c-state"><a href="https://www.w3.org/standards/types#ED">Editor’s Draft</a>, <time class="dt-updated" datetime="2024-02-10">10 February 2024</time></p>
+   <p id="w3c-state"><a href="https://www.w3.org/standards/types#ED">Editor’s Draft</a>, <time class="dt-updated" datetime="2024-04-22">22 April 2024</time></p>
    <details open>
     <summary>More details about this document</summary>
     <div data-fill-with="spec-metadata">
@@ -1031,7 +1031,7 @@ <h3 class="heading settled" data-level="3.4" id="xrcompositionlayertype"><span c
      <li data-md>
       <p>Set <var>layer</var>’s <code class="idl"><a data-link-type="idl" href="#dom-xrcompositionlayer-needsredraw" id="ref-for-dom-xrcompositionlayer-needsredraw①">needsRedraw</a></code> to <code>true</code>.</p>
      <li data-md>
-      <p>If <var>layer</var> is not an <code class="idl"><a data-link-type="idl" href="#xrprojectionlayer" id="ref-for-xrprojectionlayer③">XRProjectionLayer</a></code>, <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/webappapis.html#queue-a-task" id="ref-for-queue-a-task">queue a task</a> to <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 <code class="idl"><a data-link-type="idl" href="#eventdef-xrlayer-redraw" id="ref-for-eventdef-xrlayer-redraw">redraw</a></code> using <code class="idl"><a data-link-type="idl" href="#xrlayerevent" id="ref-for-xrlayerevent">XRLayerEvent</a></code> on <var>layer</var>.</p>
+      <p>If <var>layer</var> is not an <code class="idl"><a data-link-type="idl" href="#xrprojectionlayer" id="ref-for-xrprojectionlayer③">XRProjectionLayer</a></code>, <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/webappapis.html#queue-a-task" id="ref-for-queue-a-task">queue a task</a> to <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 <code class="idl"><a data-link-type="idl" href="#eventdef-xrquadlayer-redraw" id="ref-for-eventdef-xrquadlayer-redraw">redraw</a></code> using <code class="idl"><a data-link-type="idl" href="#xrlayerevent" id="ref-for-xrlayerevent">XRLayerEvent</a></code> on <var>layer</var>.</p>
     </ol>
    </div>
    <p><code class="idl"><a data-link-type="idl" href="#dom-xrcompositionlayer-destroy" id="ref-for-dom-xrcompositionlayer-destroy">destroy()</a></code> will delete the underlying attachments. If there are no attachments, this function does nothing.</p>
@@ -1163,7 +1163,7 @@ <h3 class="heading settled" data-level="3.6" id="xrquadlayertype"><span class="s
       <p>Initialize <var>layer</var>’s <a data-link-type="dfn" href="#xrcompositionlayer-isstatic" id="ref-for-xrcompositionlayer-isstatic①">isStatic</a> to <var>init</var>’s <code class="idl"><a data-link-type="idl" href="#dom-xrlayerinit-isstatic" id="ref-for-dom-xrlayerinit-isstatic">isStatic</a></code></p>
     </ol>
    </div>
-   <p>The <dfn class="dfn-paneled idl-code" data-dfn-for="XRQuadLayer" data-dfn-type="attribute" data-export id="dom-xrquadlayer-onredraw"><code>onredraw</code></dfn> attribute is an Event handler IDL attribute for the <code class="idl"><a data-link-type="idl" href="#eventdef-xrlayer-redraw" id="ref-for-eventdef-xrlayer-redraw①">redraw</a></code> event type.</p>
+   <p>The <dfn class="dfn-paneled idl-code" data-dfn-for="XRQuadLayer" data-dfn-type="attribute" data-export id="dom-xrquadlayer-onredraw"><code>onredraw</code></dfn> attribute is an Event handler IDL attribute for the <code class="idl"><a data-link-type="idl" href="#eventdef-xrquadlayer-redraw" id="ref-for-eventdef-xrquadlayer-redraw①">redraw</a></code> event type.</p>
    <h3 class="heading settled" data-level="3.7" id="xrcylinderayertype"><span class="secno">3.7. </span><span class="content">XRCylinderLayer</span><a class="self-link" href="#xrcylinderayertype"></a></h3>
     An <code class="idl"><a data-link-type="idl" href="#xrcylinderlayer" id="ref-for-xrcylinderlayer">XRCylinderLayer</a></code> renders a layer that takes up a curved rectangular space in the virtual environment.
 Only the front of the layer MUST be visible; the back face MUST NOT be drawn by the <a data-link-type="dfn" href="https://www.w3.org/TR/webxr/#xr-compositor" id="ref-for-xr-compositor①⑧">XR Compositor</a>. 
@@ -1213,7 +1213,7 @@ <h3 class="heading settled" data-level="3.7" id="xrcylinderayertype"><span class
       <p>Initialize <var>layer</var>’s <a data-link-type="dfn" href="#xrcompositionlayer-isstatic" id="ref-for-xrcompositionlayer-isstatic②">isStatic</a> to <var>init</var>’s <code class="idl"><a data-link-type="idl" href="#dom-xrlayerinit-isstatic" id="ref-for-dom-xrlayerinit-isstatic①">isStatic</a></code></p>
     </ol>
    </div>
-   <p>The <dfn class="dfn-paneled idl-code" data-dfn-for="XRCylinderLayer" data-dfn-type="attribute" data-export id="dom-xrcylinderlayer-onredraw"><code>onredraw</code></dfn> attribute is an Event handler IDL attribute for the <code class="idl"><a data-link-type="idl" href="#eventdef-xrlayer-redraw" id="ref-for-eventdef-xrlayer-redraw②">redraw</a></code> event type.</p>
+   <p>The <dfn class="dfn-paneled idl-code" data-dfn-for="XRCylinderLayer" data-dfn-type="attribute" data-export id="dom-xrcylinderlayer-onredraw"><code>onredraw</code></dfn> attribute is an Event handler IDL attribute for the <code class="idl"><a data-link-type="idl" href="#eventdef-xrquadlayer-redraw" id="ref-for-eventdef-xrquadlayer-redraw②">redraw</a></code> event type.</p>
    <h3 class="heading settled" data-level="3.8" id="xrequirectlayertype"><span class="secno">3.8. </span><span class="content">XREquirectLayer</span><a class="self-link" href="#xrequirectlayertype"></a></h3>
     An <code class="idl"><a data-link-type="idl" href="#xrequirectlayer" id="ref-for-xrequirectlayer">XREquirectLayer</a></code> renders a layer where the <a data-link-type="dfn" href="https://www.w3.org/TR/webxr/#xr-compositor" id="ref-for-xr-compositor①⑨">XR Compositor</a> MUST map an equirectangular coded data onto the inside of a sphere. 
    <p><img alt="representation of an equirect layer" height="2048" src="images/equirect-layer.png" style="width:50%; height: 50%; border-style: ridge;" width="2048"></p>
@@ -1277,7 +1277,7 @@ <h3 class="heading settled" data-level="3.8" id="xrequirectlayertype"><span clas
       <p>Initialize <var>layer</var>’s <a data-link-type="dfn" href="#xrcompositionlayer-isstatic" id="ref-for-xrcompositionlayer-isstatic③">isStatic</a> to <var>init</var>’s <code class="idl"><a data-link-type="idl" href="#dom-xrlayerinit-isstatic" id="ref-for-dom-xrlayerinit-isstatic②">isStatic</a></code></p>
     </ol>
    </div>
-   <p>The <dfn class="dfn-paneled idl-code" data-dfn-for="XREquirectLayer" data-dfn-type="attribute" data-export id="dom-xrequirectlayer-onredraw"><code>onredraw</code></dfn> attribute is an Event handler IDL attribute for the <code class="idl"><a data-link-type="idl" href="#eventdef-xrlayer-redraw" id="ref-for-eventdef-xrlayer-redraw③">redraw</a></code> event type.</p>
+   <p>The <dfn class="dfn-paneled idl-code" data-dfn-for="XREquirectLayer" data-dfn-type="attribute" data-export id="dom-xrequirectlayer-onredraw"><code>onredraw</code></dfn> attribute is an Event handler IDL attribute for the <code class="idl"><a data-link-type="idl" href="#eventdef-xrquadlayer-redraw" id="ref-for-eventdef-xrquadlayer-redraw③">redraw</a></code> event type.</p>
    <h3 class="heading settled" data-level="3.9" id="xcubelayertype"><span class="secno">3.9. </span><span class="content">XRCubeLayer</span><a class="self-link" href="#xcubelayertype"></a></h3>
     A <code class="idl"><a data-link-type="idl" href="#xrcubelayer" id="ref-for-xrcubelayer">XRCubeLayer</a></code> renders a layer where the <a data-link-type="dfn" href="https://www.w3.org/TR/webxr/#xr-compositor" id="ref-for-xr-compositor②⓪">XR Compositor</a> renders directly from a cubemap. 
    <p><img alt="representation of a cube layer" height="2048" src="images/cube-layer.jpg" style="width:50%; height: 50%; border-style: ridge;" width="2048"></p>
@@ -1306,7 +1306,7 @@ <h3 class="heading settled" data-level="3.9" id="xcubelayertype"><span class="se
       <p>Run <a data-link-type="dfn" href="#setting-the-space-on-a-layer" id="ref-for-setting-the-space-on-a-layer③">setting the space on a layer</a> with <var>space</var> and <var>layer</var>.</p>
     </ol>
    </div>
-   <p>The <dfn class="dfn-paneled idl-code" data-dfn-for="XRCubeLayer" data-dfn-type="attribute" data-export id="dom-xrcubelayer-onredraw"><code>onredraw</code></dfn> attribute is an Event handler IDL attribute for the <code class="idl"><a data-link-type="idl" href="#eventdef-xrlayer-redraw" id="ref-for-eventdef-xrlayer-redraw④">redraw</a></code> event type.</p>
+   <p>The <dfn class="dfn-paneled idl-code" data-dfn-for="XRCubeLayer" data-dfn-type="attribute" data-export id="dom-xrcubelayer-onredraw"><code>onredraw</code></dfn> attribute is an Event handler IDL attribute for the <code class="idl"><a data-link-type="idl" href="#eventdef-xrquadlayer-redraw" id="ref-for-eventdef-xrquadlayer-redraw④">redraw</a></code> event type.</p>
    <h2 class="heading settled" data-level="4" id="spaces"><span class="secno">4. </span><span class="content">Spaces</span><a class="self-link" href="#spaces"></a></h2>
    <p><code class="idl"><a data-link-type="idl" href="#xrprojectionlayer" id="ref-for-xrprojectionlayer⑥">XRProjectionLayer</a></code> and <code class="idl"><a data-link-type="idl" href="https://immersive-web.github.io/webxr/#xrwebgllayer" id="ref-for-xrwebgllayer①">XRWebGLLayer</a></code> don’t have associated an <code class="idl"><a data-link-type="idl" href="https://immersive-web.github.io/webxr/#xrspace" id="ref-for-xrspace⑨">XRSpace</a></code> because they render to the full frame.</p>
    <p><code class="idl"><a data-link-type="idl" href="#xrcubelayer" id="ref-for-xrcubelayer③">XRCubeLayer</a></code> and <code class="idl"><a data-link-type="idl" href="#xrequirectlayer" id="ref-for-xrequirectlayer③">XREquirectLayer</a></code> MUST only support <code class="idl"><a data-link-type="idl" href="https://immersive-web.github.io/webxr/#xrreferencespace" id="ref-for-xrreferencespace②">XRReferenceSpaces</a></code> that are not of type <code class="idl"><a data-link-type="idl" href="https://immersive-web.github.io/webxr/#dom-xrreferencespacetype-viewer" id="ref-for-dom-xrreferencespacetype-viewer②">"viewer"</a></code>.</p>
@@ -2762,7 +2762,7 @@ <h3 class="heading settled" data-level="8.1" id="xrlayerevent-interface"><span c
    <p>The <dfn class="dfn-paneled idl-code" data-dfn-for="XRLayerEvent" data-dfn-type="attribute" data-export id="dom-xrlayerevent-layer"><code>layer</code></dfn> attribute indicates the <code class="idl"><a data-link-type="idl" href="https://immersive-web.github.io/webxr/#xrlayer" id="ref-for-xrlayer⑨">XRLayer</a></code> that generated the event.</p>
    <h3 class="heading settled" data-level="8.2" id="event-types"><span class="secno">8.2. </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 DOM4 Events.</p>
-   <p>The user agent MAY fire a <dfn class="dfn-paneled idl-code" data-dfn-for="XRLayer" data-dfn-type="event" data-export id="eventdef-xrlayer-redraw"><code>redraw</code></dfn> event on the <code class="idl"><a data-link-type="idl" href="https://immersive-web.github.io/webxr/#xrlayer" id="ref-for-xrlayer①⓪">XRLayer</a></code> object when <a data-link-type="dfn" href="#the-underlying-resources-of-a-layer-are-lost" id="ref-for-the-underlying-resources-of-a-layer-are-lost①">the underlying resources of a layer are lost</a> or
+   <p>The user agent MAY fire a <dfn class="dfn-paneled idl-code" data-dfn-for="XRQuadLayer,XRCylinderLayer,XREquirectLayer,XRCubeLayer" data-dfn-type="event" data-export id="eventdef-xrquadlayer-redraw"><code>redraw</code></dfn> event on the <code class="idl"><a data-link-type="idl" href="https://immersive-web.github.io/webxr/#xrlayer" id="ref-for-xrlayer①⓪">XRLayer</a></code> object when <a data-link-type="dfn" href="#the-underlying-resources-of-a-layer-are-lost" id="ref-for-the-underlying-resources-of-a-layer-are-lost①">the underlying resources of a layer are lost</a> or
 when the <a data-link-type="dfn" href="https://www.w3.org/TR/webxr/#xr-compositor" id="ref-for-xr-compositor③⑨">XR Compositor</a> can no longer reproject the layer.</p>
    <p>The author SHOULD redraw the content of the layer at the next <a data-link-type="dfn" href="https://immersive-web.github.io/webxr/#xr-animation-frame" id="ref-for-xr-animation-frame⑥">XR animation frame</a>. The event must be of type <code class="idl"><a data-link-type="idl" href="#xrlayerevent" id="ref-for-xrlayerevent②">XRLayerEvent</a></code>.</p>
    <h2 class="heading settled" data-level="9" id="depthsorting"><span class="secno">9. </span><span class="content">Depth sorting between layers</span><a class="self-link" href="#depthsorting"></a></h2>
@@ -3173,7 +3173,7 @@ <h3 class="no-num no-ref heading settled" id="index-defined-here"><span class="c
    <li><a href="#recommended-motion-vector-texture-resolution">recommended motion vector texture resolution</a><span>, in § 11.4</span>
    <li><a href="#recommended-webgl-color-texture-resolution">recommended WebGL color texture resolution</a><span>, in § 11.4</span>
    <li><a href="#recommended-webgl-depth-texture-resolution">recommended WebGL depth texture resolution</a><span>, in § 11.4</span>
-   <li><a href="#eventdef-xrlayer-redraw">redraw</a><span>, in § 8.2</span>
+   <li><a href="#eventdef-xrquadlayer-redraw">redraw</a><span>, in § 8.2</span>
    <li><a href="#dom-xrprojectionlayerinit-scalefactor">scaleFactor</a><span>, in § 6.3</span>
    <li>
     session
@@ -3472,7 +3472,7 @@ <h2 class="no-num no-ref heading settled" id="references"><span class="content">
   <h3 class="no-num no-ref heading settled" id="normative"><span class="content">Normative References</span><a class="self-link" href="#normative"></a></h3>
   <dl>
    <dt id="biblio-compositing-1">[COMPOSITING-1]
-   <dd>Rik Cabanier; Nikos Andronikos. <a href="https://drafts.fxtf.org/compositing-1/"><cite>Compositing and Blending Level 1</cite></a>. URL: <a href="https://drafts.fxtf.org/compositing-1/">https://drafts.fxtf.org/compositing-1/</a>
+   <dd>Chris Harrelson. <a href="https://drafts.fxtf.org/compositing-1/"><cite>Compositing and Blending Level 1</cite></a>. URL: <a href="https://drafts.fxtf.org/compositing-1/">https://drafts.fxtf.org/compositing-1/</a>
    <dt id="biblio-css-writing-modes-4">[CSS-WRITING-MODES-4]
    <dd>Elika Etemad; Koji Ishii. <a href="https://drafts.csswg.org/css-writing-modes-4/"><cite>CSS Writing Modes Level 4</cite></a>. URL: <a href="https://drafts.csswg.org/css-writing-modes-4/">https://drafts.csswg.org/css-writing-modes-4/</a>
    <dt id="biblio-dom">[DOM]
@@ -4343,7 +4343,7 @@ <h2 class="no-num no-ref heading settled" id="issues-index"><span class="content
 window.dfnpanelData['xrlayerevent'] = {"dfnID": "xrlayerevent", "url": "#xrlayerevent", "dfnText": "XRLayerEvent", "refSections": [{"refs": [{"id": "ref-for-xrlayerevent"}], "title": "3.4. XRCompositionLayer"}, {"refs": [{"id": "ref-for-xrlayerevent\u2460"}], "title": "8.1. XRLayerEvent"}, {"refs": [{"id": "ref-for-xrlayerevent\u2461"}], "title": "8.2. Event Types"}], "external": false};
 window.dfnpanelData['dictdef-xrlayereventinit'] = {"dfnID": "dictdef-xrlayereventinit", "url": "#dictdef-xrlayereventinit", "dfnText": "XRLayerEventInit", "refSections": [{"refs": [{"id": "ref-for-dictdef-xrlayereventinit"}], "title": "8.1. XRLayerEvent"}], "external": false};
 window.dfnpanelData['dom-xrlayerevent-layer'] = {"dfnID": "dom-xrlayerevent-layer", "url": "#dom-xrlayerevent-layer", "dfnText": "layer", "refSections": [{"refs": [{"id": "ref-for-dom-xrlayerevent-layer"}], "title": "8.1. XRLayerEvent"}], "external": false};
-window.dfnpanelData['eventdef-xrlayer-redraw'] = {"dfnID": "eventdef-xrlayer-redraw", "url": "#eventdef-xrlayer-redraw", "dfnText": "redraw", "refSections": [{"refs": [{"id": "ref-for-eventdef-xrlayer-redraw"}], "title": "3.4. XRCompositionLayer"}, {"refs": [{"id": "ref-for-eventdef-xrlayer-redraw\u2460"}], "title": "3.6. XRQuadLayer"}, {"refs": [{"id": "ref-for-eventdef-xrlayer-redraw\u2461"}], "title": "3.7. XRCylinderLayer"}, {"refs": [{"id": "ref-for-eventdef-xrlayer-redraw\u2462"}], "title": "3.8. XREquirectLayer"}, {"refs": [{"id": "ref-for-eventdef-xrlayer-redraw\u2463"}], "title": "3.9. XRCubeLayer"}], "external": false};
+window.dfnpanelData['eventdef-xrquadlayer-redraw'] = {"dfnID": "eventdef-xrquadlayer-redraw", "url": "#eventdef-xrquadlayer-redraw", "dfnText": "redraw", "refSections": [{"refs": [{"id": "ref-for-eventdef-xrquadlayer-redraw"}], "title": "3.4. XRCompositionLayer"}, {"refs": [{"id": "ref-for-eventdef-xrquadlayer-redraw\u2460"}], "title": "3.6. XRQuadLayer"}, {"refs": [{"id": "ref-for-eventdef-xrquadlayer-redraw\u2461"}], "title": "3.7. XRCylinderLayer"}, {"refs": [{"id": "ref-for-eventdef-xrquadlayer-redraw\u2462"}], "title": "3.8. XREquirectLayer"}, {"refs": [{"id": "ref-for-eventdef-xrquadlayer-redraw\u2463"}], "title": "3.9. XRCubeLayer"}], "external": false};
 window.dfnpanelData['feature-descriptor-depth-sorted-layers'] = {"dfnID": "feature-descriptor-depth-sorted-layers", "url": "#feature-descriptor-depth-sorted-layers", "dfnText": "depth-sorted-layers", "refSections": [{"refs": [{"id": "ref-for-feature-descriptor-depth-sorted-layers"}, {"id": "ref-for-feature-descriptor-depth-sorted-layers\u2460"}], "title": "9. Depth sorting between layers"}, {"refs": [{"id": "ref-for-feature-descriptor-depth-sorted-layers\u2461"}], "title": "11.1. XRRenderState changes"}, {"refs": [{"id": "ref-for-feature-descriptor-depth-sorted-layers\u2462"}], "title": "11.4. XRView changes"}], "external": false};
 window.dfnpanelData['space-warp'] = {"dfnID": "space-warp", "url": "#space-warp", "dfnText": "Space warp", "refSections": [{"refs": [{"id": "ref-for-space-warp"}], "title": "10. Space warp"}], "external": false};
 window.dfnpanelData['feature-descriptor-space-warp'] = {"dfnID": "feature-descriptor-space-warp", "url": "#feature-descriptor-space-warp", "dfnText": "space-warp", "refSections": [{"refs": [{"id": "ref-for-feature-descriptor-space-warp"}], "title": "3.5. XRProjectionLayer"}, {"refs": [{"id": "ref-for-feature-descriptor-space-warp\u2460"}, {"id": "ref-for-feature-descriptor-space-warp\u2461"}], "title": "5.2. XRWebGLSubImage"}, {"refs": [{"id": "ref-for-feature-descriptor-space-warp\u2462"}], "title": "6.9. XRWebGLBinding"}, {"refs": [{"id": "ref-for-feature-descriptor-space-warp\u2463"}], "title": "10. Space warp"}, {"refs": [{"id": "ref-for-feature-descriptor-space-warp\u2464"}, {"id": "ref-for-feature-descriptor-space-warp\u2465"}], "title": "11.4. XRView changes"}], "external": false};