Skip to content

Commit

Permalink
Updated WebVMT Editor's Draft
Browse files Browse the repository at this point in the history 
Added map & media to data model
  • Loading branch information
@rjksmith
rjksmith committed Oct 9, 2018
1 parent bd60bbb commit 94551da
Showing 1 changed file with 67 additions and 9 deletions.
76 changes: 67 additions & 9 deletions proposals/geotagging/webvmt/index.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -657,7 +657,7 @@ <h2>Hello YouTube</h2>
<section class='informative' id='datamodel'>
<h2>Data Model</h2>
<p class='ednote'>
The data model of WebVMT consists of three key elements: the video viewport, cues, and the map viewport. The video viewport is the rendering area for video output. Cues are containers consisting of a set of metadata lines. The map viewport is the rendering area for metadata output, for example graphical annotations overlaid on an online map.
The data model of WebVMT consists of four key elements: the linked media file, the video viewport, cues, and the map viewport. The linked media file contains audio or video data with which cues are synchronised. The video viewport is the rendering area for video output. Cues are containers consisting of a set of metadata lines. The map viewport is the rendering area for metadata output, for example graphical annotations overlaid on an online map.
</p>
<section class='informative' id='overview'>
<h2>Overview</h2>
Expand All @@ -682,20 +682,78 @@ <h2>WebVMT Cues</h2>
<p>
A <dfn>WebVMT cue</dfn> is a <a data-cite='HTML51/semantics-embedded-content.html#cue'>text track cue</a> with an optional <a data-cite='HTML51/semantics-embedded-content.html#text-track-cue-end-time'>end time</a> and that additionally consists of the following:
</p>
<p>
<dt>
A <dfn>cue text</dfn>
</dt>
<dl>
<dt>
A <dfn>cue text</dfn>
</dt>
<dd>
The raw text of the cue which is interpreted as time-aligned metadata, and rules for its interpretation.
</dd>
</p>
</dl>
</section>
<section id='webvmtmap'>
<h2>WebVMT Map</h2>
<p>
A <dfn>WebVMT map</dfn> is the map viewport and provides a rendering area for <a>WebVMT cue</a>s.
</p>
<p>
A <a>WebVMT map</a> consists of:
</p>
<dl>
<dt>
A <dfn>center latitude</dfn>
</dt>
<dd>
The latitude of the location at the center of the map.
</dd>
<dt>
A <dfn>center longitude</dfn>
</dt>
<dd>
The longitude of the location at the center of the map.
</dd>
<dt>
A <dfn>zoom radius</dfn>
</dt>
<dd>
The radius of the minimum visible area from the center of the map.
</dd>
</dl>
</section>
<section id='webvmtmediafile'>
<h2>WebVMT Media</h2>
<p>
A <dfn>WebVMT media</dfn> is the audio or video with which <a>WebVMT cue</a>s are synchronised.
</p>
<p>
A <a>WebVMT media</a> consists of:
</p>
<dl>
<dt>
A <dfn>url</dfn>
</dt>
<dd>
The url of the linked media file.
</dd>
<dt>
A <dfn>MIME type</dfn>
</dt>
<dd>
The MIME type of the linked media file.
</dd>
<dt>
A <dfn>start time</dfn>
</dt>
<dd>
The time and date at which the linked media file begins.
</dd>
<dt>
A <dfn>path</dfn>
</dt>
<dd>
The path identifier which represents the location of the camera capturing the linked media file.
</dd>
</dl>
</section>
</section>
<section id='syntax'>
Expand Down Expand Up @@ -1041,7 +1099,7 @@ <h2>WebVMT Media Settings</h2>
<section>
<h2>WebVMT Map Settings</h2>
<p>
The <dfn>WebVMT map settings list</dfn> consists of zero or more of the following components, in any order, separated from each other by one or more U+0020 SPACE characters, U+0009 CHARACTER TABULATION (tab) characters, or <a>WebVMT line terminator</a>s, except that the string must not contain two consecutive <a>WebVMT line terminator</a>s. Each component must not be included more than once per <a>WebVMT map settings list</a> string.
The <dfn>WebVMT map settings list</dfn> consists of the following components, in any order, separated from each other by one or more U+0020 SPACE characters, U+0009 CHARACTER TABULATION (tab) characters, or <a>WebVMT line terminator</a>s, except that the string must not contain two consecutive <a>WebVMT line terminator</a>s. Each component must be included once per <a>WebVMT map settings list</a> string.
</p>
<ul>
<li>
Expand All @@ -1056,7 +1114,7 @@ <h2>WebVMT Map Settings</h2>
</p>
</p>
<p class='note' title='Map Center'>
The <a>WebVMT map center setting</a> gives the location of the center of the map.
The <a>WebVMT map center setting</a> gives the location of the center of the map at the start of the linked media file.
</p>
<p>
A <dfn>WebVMT map zoom setting</dfn> consists of the following components, in the order given:
Expand Down Expand Up @@ -1084,7 +1142,7 @@ <h2>WebVMT Map Settings</h2>
</ol>
</p>
<p class='note' title='Zoom Radius'>
When interpreted as a number, the <a>WebVMT map zoom setting</a> represents the minimum radius in metres from the central location visible in the <a>WebVMT map</a>.
When interpreted as a number, the <a>WebVMT map zoom setting</a> represents the minimum radius in metres from the central location visible in the <a>WebVMT map</a> at the start of the linked media file.
</p>
<p>
A <dfn>WebVMT location setting</dfn> consists of the following components, in any order, separated from each other by a U+002C COMMA character (,). Each component must be included once per <a>WebVMT location setting</a> string.
Expand Down

0 comments on commit 94551da

Please sign in to comment.