From 6f406058eceae4d83ff4701f43e67e9e5f959f29 Mon Sep 17 00:00:00 2001
From: Markus Handell <handellm@google.com>
Date: Mon, 9 Sep 2024 14:40:04 +0200
Subject: [PATCH] Define captureTime.

Partly addresses https://github.com/w3c/webcodecs/pull/813#pullrequestreview-2169568794.
---
 index.html | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/index.html b/index.html
index d48ea70..0a0b41d 100644
--- a/index.html
+++ b/index.html
@@ -58,6 +58,10 @@ <h2>Terminology</h2>
       <p>The terms [=permission state=], [=request permission to use=], and
       <a data-cite="permissions">prompt the user to choose</a> are defined in
       [[!permissions]].</p>
+      <p>
+        {{Performance.timeOrigin}} and {{Performance.now()}} are defined in
+        [[!hr-time]].
+      </p>
   </section>
   <section id="conformance">
   </section>
@@ -1151,6 +1155,34 @@ <h2>Constrainable Properties</h2>
         </tbody>
       </table>
     </section>
+    <section>
+      <h2>Capture timestamps</h2>
+      <div>
+        <p>
+          Some video sources can supply information about when a video frame was captured.
+          This information is useful for example for AV sync and end-to-end delay measurement.
+          It MAY be set by the user agent (and be present in {{VideoFrameMetadata}}) by local capturers, or it
+          MAY be supplied in {{VideoFrameMetadata}} when a VideoFrame is created.
+        </p>
+        <section>
+          <h3>{{VideoFrameMetadata}}</h3>
+          <pre class="idl" data-cite="HR-TIME">
+    partial dictionary VideoFrameMetadata {
+      DOMHighResTimeStamp captureTime;
+    };</pre>
+          <section class="notoc">
+            <h4>Members</h4>
+            <dl class="dictionary-members" data-link-for="VideoFrameMetadata" data-dfn-for="VideoFrameMetadata">
+              <dt><dfn><code>captureTime</code></dfn> of type <span
+                class="idlMemberType">DOMHighResTimeStamp, readonly</span></dt>
+              <dd>
+                <p data-cite="HR-TIME">The capture time of the frame. The timestamp is defined as {{Performance.timeOrigin}} + {{Performance.now()}} at that time.</p>
+              </dd>
+            </dl>
+          </section>
+        </section>
+      </div>
+    </section>
   <section>
     <h2>Exposing MediaStreamTrack source heuristic reactions support</h2>
     <div>