[ttml2] add uses{Forced,Stereo} named metadata items
authorGlenn Adams <glenn@skynav.com>
Sun, 18 Jan 2015 10:38:57 -0700
changeset 848 728da0355d57
parent 847 fd906e8ca005
child 849 b09c35d2aa4a
[ttml2] add uses{Forced,Stereo} named metadata items
ttml2/spec/ttml2.xml
--- a/ttml2/spec/ttml2.xml	Sun Jan 18 10:05:24 2015 -0700
+++ b/ttml2/spec/ttml2.xml	Sun Jan 18 10:38:57 2015 -0700
@@ -5731,8 +5731,10 @@
 <gitem id="bound-parameter-forced">
 <label><code>forced</code></label>
 <def>
-<p>Evaluates to a boolean value that denotes if the <loc href="#terms-content-processor">content processor</loc> is operating with
-<loc href="#terms-forced-subtitle">forced subtitles</loc> enabled.</p>
+<p>Evaluates to a boolean value that denotes whether the <loc href="#terms-content-processor">content processor</loc> is operating with
+<loc href="#terms-forced-subtitle">forced subtitles</loc> enabled.
+If used in a <loc href="#terms-document-instance">document instance</loc>, then a <loc href="#named-item-usesForced"><code>usesForced</code></loc>
+named metadata item should be specified as a child of the <loc href="#document-structure-vocabulary-head"><el>head</el></loc> element.</p>
 </def>
 </gitem>
 <gitem id="bound-parameter-mediaAspectRatio">
@@ -5750,15 +5752,19 @@
 <gitem id="bound-parameter-stereoLeft">
 <label><code>stereoLeft</code></label>
 <def>
-<p>Evaluates to a boolean value that denotes if the <loc href="#terms-content-processor">content processor</loc> is processing the
-left image of a stereo presentation.</p>
+<p>Evaluates to a boolean value that denotes whether the <loc href="#terms-content-processor">content processor</loc> is processing the
+left image of a stereo presentation.
+If used in a <loc href="#terms-document-instance">document instance</loc>, then a <loc href="#named-item-usesStereo"><code>usesStereo</code></loc>
+named metadata item should be specified as a child of the <loc href="#document-structure-vocabulary-head"><el>head</el></loc> element.</p>
 </def>
 </gitem>
 <gitem id="bound-parameter-stereoRight">
 <label><code>stereoRight</code></label>
 <def>
-<p>Evaluates to a boolean value that denotes if the <loc href="#terms-content-processor">content processor</loc> is processing the
-right image of a stereo presentation.</p>
+<p>Evaluates to a boolean value that denotes whether the <loc href="#terms-content-processor">content processor</loc> is processing the
+right image of a stereo presentation.
+If used in a <loc href="#terms-document-instance">document instance</loc>, then a <loc href="#named-item-usesStereo"><code>usesStereo</code></loc>
+named metadata item should be specified as a child of the <loc href="#document-structure-vocabulary-head"><el>head</el></loc> element.</p>
 </def>
 </gitem>
 <gitem id="bound-parameter-userLanguage">
@@ -11311,8 +11317,8 @@
 &lt;region xml:id="r1"&gt;
   &lt;style tts:extent="30% 10%"/&gt;
   &lt;style tts:position="center bottom 10%"/&gt;
-  &lt;style condition="parameter('stereoLeft')" <phrase role="strong">tts:translate="-10px 0%"</phrase>/&gt;
-  &lt;style condition="parameter('stereoRight)" <phrase role="strong">tts:translate="+10px 0%"</phrase>/&gt;
+  &lt;style condition="parameter('stereoLeft')" <phrase role="strong">tts:translate="-10 0"</phrase>/&gt;
+  &lt;style condition="parameter('stereoRight)" <phrase role="strong">tts:translate="+10 0"</phrase>/&gt;
 &lt;/region&gt;
 ...
 &lt;p region="r1"&gt;
@@ -11323,6 +11329,11 @@
 </tr>
 </tbody>
 </table>
+<note role="elaboration">
+<p>The above example elides the <code>units</code> component from the <loc href="#style-value-length">&lt;length&gt;</loc> expressions of
+the <att>tts:translate</att> style attribute, which is now permitted in TTML2. In the absence of a <code>units</code> component, <code>px</code>
+units apply.</p>
+</note>
 <p></p>
 <ednote>
 <name>Translate Example</name>
@@ -12536,8 +12547,8 @@
 </tr>
 </tbody>
 </table>
-<p>If no <emph>unit</emph> is specified in a &lt;length&gt; expression, then it is to be treated as
-if a unit of <code>px</code> (pixels) were specified.</p>
+<p>If no <emph>units</emph> component is specified in a &lt;length&gt; expression, then it is to be treated as
+if <code>px</code> (pixels) units were specified.</p>
 <p>The semantics of
 the unit of measure <code>px</code> (pixel) 
 are as defined by <bibref ref="xsl11"/>, &sect; 5.9.13.</p>
@@ -16351,6 +16362,8 @@
   | translatedProgramTitle
   | translator
   | translatorContact
+  | usesForced
+  | usesStereo
 </eg>
 </td>
 </tr>
@@ -16457,7 +16470,7 @@
 <def>
 <p>A real number that expresses a threshold parameter used to suppress the inclusion of temporary timed states when
 transforming amongst a CEA-708 caption service and a <loc href="#terms-timed-text-content-document">timed text content document</loc>,
-where the value adheres to <loc href="http://www.w3.org/TR/xmlschema-2/#boolean">xsd:float</loc>.</p>
+where the value adheres to <loc href="http://www.w3.org/TR/xmlschema-2/#float">xsd:float</loc>.</p>
 </def>
 </gitem>
 <gitem id="named-item-creationCountryOfOrigin">
@@ -16633,6 +16646,27 @@
 adheres to <loc href="http://www.w3.org/TR/xmlschema-2/#string">xsd:string</loc>.</p>
 </def>
 </gitem>
+<gitem id="named-item-usesForced">
+<label><code>usesForced</code></label>
+<def>
+<p>A boolean that expresses whether some <loc href="#content-value-condition">&lt;condition&gt;</loc> expression
+makes use of the <loc href="#bound-parameter-forced"><code>forced</code></loc> bound parameter, where the value
+adheres to <loc href="http://www.w3.org/TR/xmlschema-2/#boolean">xsd:boolean</loc>. If this named metadata item
+is present in a <loc href="#terms-document-instance">document instance</loc>, then it must be specified as a child
+of the <loc href="#document-structure-vocabulary-head"><el>head</el></loc> element.</p>
+</def>
+</gitem>
+<gitem id="named-item-usesStereo">
+<label><code>usesStereo</code></label>
+<def>
+<p>A boolean that expresses whether some <loc href="#content-value-condition">&lt;condition&gt;</loc> expression
+makes use of the <loc href="#bound-parameter-steroLeft"><code>stereoLeft</code></loc> or
+<loc href="#bound-parameter-steroRight"><code>stereoRight</code></loc> bound parameter,
+where the value adheres to <loc href="http://www.w3.org/TR/xmlschema-2/#boolean">xsd:boolean</loc>. If this named metadata item
+is present in a <loc href="#terms-document-instance">document instance</loc>, then it must be specified as a child
+of the <loc href="#document-structure-vocabulary-head"><el>head</el></loc> element.</p>
+</def>
+</gitem>
 </glist>
 </div3>
 </div2> <!-- metadata-value-expressions -->