[ttml2] recast tts:translate as tts:disparity
authorGlenn Adams <glenn@skynav.com>
Sun, 25 Jan 2015 14:46:52 -0700
changeset 853 9b8dc79e4004
parent 852 5e990b5a329a
child 854 59f1b0ba73aa
[ttml2] recast tts:translate as tts:disparity
ttml2/spec/rnc/ttml2-datatypes.rnc
ttml2/spec/rnc/ttml2-styling-attribs.rnc
ttml2/spec/ttml2-changes.html
ttml2/spec/ttml2.xml
ttml2/spec/xsd/ttml2-datatypes.xsd
ttml2/spec/xsd/ttml2-styling-attribs.xsd
--- a/ttml2/spec/rnc/ttml2-datatypes.rnc	Sun Jan 25 13:58:30 2015 -0700
+++ b/ttml2/spec/rnc/ttml2-datatypes.rnc	Sun Jan 25 14:46:52 2015 -0700
@@ -71,6 +71,9 @@
   "ltr" |
   "rtl"
 
+TTAF.Disparity.datatype =
+  string
+
 TTAF.Display.datatype =
   "auto" |
   "none"
@@ -430,9 +433,6 @@
 TTAF.TimeDuration.datatype =
   string
 
-TTAF.Translate.datatype =
-  string
-
 TTAF.URI.datatype =
   xsd:anyURI
 
--- a/ttml2/spec/rnc/ttml2-styling-attribs.rnc	Sun Jan 25 13:58:30 2015 -0700
+++ b/ttml2/spec/rnc/ttml2-styling-attribs.rnc	Sun Jan 25 14:46:52 2015 -0700
@@ -22,6 +22,8 @@
   = attribute tts:color { TTAF.Color.datatype }?
 TTAF.direction.attrib
   = attribute tts:direction { TTAF.Direction.datatype }?
+TTAF.disparity.attrib
+  = attribute tts:disparity { TTAF.Disparity.datatype }?
 TTAF.display.attrib
   = attribute tts:display { TTAF.Display.datatype }?
 TTAF.displayAlign.attrib
@@ -82,8 +84,6 @@
   = attribute tts:textOutline { TTAF.TextOutline.datatype }?
 TTAF.textShadow.attrib
   = attribute tts:textShadow { TTAF.TextShadow.datatype }?
-TTAF.translate.attrib
-  = attribute tts:translate { TTAF.Translate.datatype }?
 TTAF.unicodeBidi.attrib
   = attribute tts:unicodeBidi { TTAF.UnicodeBidi.datatype }?
 TTAF.visibility.attrib
@@ -112,6 +112,7 @@
   TTAF.border.attrib,
   TTAF.color.attrib,
   TTAF.direction.attrib,
+  TTAF.disparity.attrib,
   TTAF.display.attrib,
   TTAF.displayAlign.attrib,
   TTAF.extent.attrib,
@@ -141,7 +142,6 @@
   TTAF.textOrientation.attrib,
   TTAF.textOutline.attrib,
   TTAF.textShadow.attrib,
-  TTAF.translate.attrib,
   TTAF.unicodeBidi.attrib,
   TTAF.visibility.attrib,
   TTAF.width.attrib,
--- a/ttml2/spec/ttml2-changes.html	Sun Jan 25 13:58:30 2015 -0700
+++ b/ttml2/spec/ttml2-changes.html	Sun Jan 25 14:46:52 2015 -0700
@@ -88,6 +88,7 @@
   'tts:backgroundPosition',
   'tts:backgroundRepeat',
   'tts:border',
+  'tts:disparity,
   'tts:fontKerning,
   'tts:fontSelectionStrategy',
   'tts:fontShear,
@@ -102,8 +103,7 @@
   'tts:textCombine,
   'tts:textEmphasis,
   'tts:textOrientation',
-  'tts:textShadow',
-  'tts:translate, and
+  'tts:textShadow', and
   'tts:width'
   to Table 5-5.
 
@@ -243,6 +243,8 @@
 
 * In 10.2, add 'tts:border' styling attribute.
 
+* In 10.2, add 'tts:disparity styling attribute.
+
 * In 10.2, add 'tts:fontKerning' styling attribute.
 
 * In 10.2, add 'tts:fontSelectionStrategy' styling attribute.
@@ -273,8 +275,6 @@
 
 * In 10.2, add 'tts:textShadow' styling attribute.
 
-* In 10.2, add 'tts:translate' styling attribute.
-
 * In 10.2, add 'tts:width' styling attribute.
 
 * In 10.2 prologue, add proscription against specifying non-applicable,,
--- a/ttml2/spec/ttml2.xml	Sun Jan 25 13:58:30 2015 -0700
+++ b/ttml2/spec/ttml2.xml	Sun Jan 25 14:46:52 2015 -0700
@@ -2993,6 +2993,7 @@
 <loc href="#style-attribute-border">tts:border</loc>,
 <loc href="#style-attribute-color">tts:color</loc>,
 <loc href="#style-attribute-direction">tts:direction</loc>,
+<loc href="#style-attribute-disparity">tts:disparity</loc>,
 <loc href="#style-attribute-display">tts:display</loc>,
 <loc href="#style-attribute-displayAlign">tts:displayAlign</loc>,
 <loc href="#style-attribute-extent">tts:extent</loc>,
@@ -3024,7 +3025,6 @@
 <loc href="#style-attribute-textOrientation">tts:textOrientation</loc>,
 <loc href="#style-attribute-textOutline">tts:textOutline</loc>,
 <loc href="#style-attribute-textShadow">tts:textShadow</loc>,
-<loc href="#style-attribute-translate">tts:translate</loc>,
 <loc href="#style-attribute-unicodeBidi">tts:unicodeBidi</loc>,
 <loc href="#style-attribute-visibility">tts:visibility</loc>,
 <loc href="#style-attribute-width">tts:width</loc>,
@@ -7300,6 +7300,7 @@
 <item><p><specref ref="style-attribute-border"/></p></item>
 <item><p><specref ref="style-attribute-color"/></p></item>
 <item><p><specref ref="style-attribute-direction"/></p></item>
+<item><p><specref ref="style-attribute-disparity"/></p></item>
 <item><p><specref ref="style-attribute-display"/></p></item>
 <item><p><specref ref="style-attribute-displayAlign"/></p></item>
 <item><p><specref ref="style-attribute-extent"/></p></item>
@@ -7331,7 +7332,6 @@
 <item><p><specref ref="style-attribute-textOrientation"/></p></item>
 <item><p><specref ref="style-attribute-textOutline"/></p></item>
 <item><p><specref ref="style-attribute-textShadow"/></p></item>
-<item><p><specref ref="style-attribute-translate"/></p></item>
 <item><p><specref ref="style-attribute-unicodeBidi"/></p></item>
 <item><p><specref ref="style-attribute-visibility"/></p></item>
 <item><p><specref ref="style-attribute-width"/></p></item>
@@ -8094,6 +8094,94 @@
 &sect; 7.29.1.</p>
 </note>
 </div3>
+<div3 id="style-attribute-disparity">
+<head>tts:disparity</head>
+<p>The <att>tts:disparity</att> attribute is used to specify the binocular disparity to be applied
+in order to simulate stereopsis (stereoscopic depth).</p>
+<p>This attribute may be specified by any element type
+that permits use of attributes in the TT Style Namespace; however, this attribute applies
+as a style property only to those element types indicated in the following table.</p>
+<table id="style-property-details-disparity" role="common">
+<col width="25%"/>
+<col/>
+<tbody>
+<tr>
+<td><emph>Values:</emph></td>
+<td>
+<loc href="#style-value-length">&lt;length&gt;</loc>
+</td>
+</tr>
+<tr>
+<td><emph>Initial:</emph></td>
+<td><code>0</code></td>
+</tr>
+<tr>
+<td><emph>Applies to:</emph></td>
+<td>
+<loc href="#content-vocabulary-div"><el>div</el></loc>,
+<loc href="#content-vocabulary-p"><el>p</el></loc>,
+<loc href="#layout-vocabulary-region"><el>region</el></loc>
+</td>
+</tr>
+<tr>
+<td><emph>Inherited:</emph></td>
+<td>yes (see prose)</td>
+</tr>
+<tr>
+<td><emph>Percentages:</emph></td>
+<td>relative to width of <loc href="#terms-root-container-region">root container region</loc></td>
+</tr>
+<tr>
+<td><emph>Animatable:</emph></td>
+<td>discrete, continuous</td>
+</tr>
+</tbody>
+</table>
+<p>If specified, the value of this attribute consists of a <loc href="#style-value-length">&lt;length&gt;</loc> specification, the computed value
+of which is evenly divided along the horizontal axis between left and right stereoscopic images.</p>
+<p>If a <att>tts:disparity</att> attribute is specified on a <el>div</el> or <el>p</el> element, then that specification must be considered to be
+equivalent to specifying an anonymous <loc href="#terms-inline-region">inline region</loc> child of the <el>div</el> or <el>p</el> element, where the
+disparity of the corresponding region, also referred to as an <loc href="#terms-implied-inline-region">implied inline region</loc>, is equal to the
+value of this attribute.</p>
+<p>If applicable, inheritance of disparity occurs only by means of <specref ref="semantics-style-inheritance-root"/>, whether the inheriting region is
+an <loc href="#terms-out-of-line-region">out-of-line region</loc>,
+an <loc href="#terms-inline-region">inline region</loc>,
+or an <loc href="#terms-implied-inline-region">implied inline region</loc>.</p>
+<p>If a computed value of the property associated with this attribute is not supported,
+then a <loc href="#terms-presentation-processor">presentation processor</loc> must use the closest supported value.</p>
+<note role="elaboration">
+<p>In this context, the phrase <emph>closest supported value</emph> means the value for which the Euclidean distance between
+the computed disparity and the supported disparity is minimized. If there are multiple closest supported values equally distant from
+the computed value, then the value least distant from 0 is used.</p>
+</note>
+<p>The <att>tts:disparity</att> style is illustrated by the following example.</p>
+<table id="style-attribute-disparity-example-1" role="example">
+<caption>Example Fragment &ndash; Disparity</caption>
+<tbody>
+<tr>
+<td>
+<eg xml:space="preserve">
+&lt;region xml:id="r1"&gt;
+  &lt;style tts:extent="30% 10%"/&gt;
+  &lt;style tts:position="center bottom 10%"/&gt;
+  &lt;style <phrase role="strong">tts:disparity="0.7%"</phrase>/&gt;
+&lt;/region&gt;
+...
+&lt;p region="r1"&gt;
+  3D Text Sample
+&lt;/p&gt;
+</eg>
+</td>
+</tr>
+</tbody>
+</table>
+<p></p>
+<ednote>
+<name>Disparity Example</name>
+<date>2015-01-17</date>
+<edtext>Insert example image of tts:disparity.</edtext>
+</ednote>
+</div3>
 <div3 id="style-attribute-display">
 <head>tts:display</head>
 <p>The <att>tts:display</att> attribute is used to specify a style property that
@@ -11249,99 +11337,6 @@
 that defined by <bibref ref="css3-decoration"/>, &sect; 4.</p>
 </note>
 </div3>
-<div3 id="style-attribute-translate">
-<head>tts:translate</head>
-<p>The <att>tts:translate</att> attribute is used to specify <emph>x</emph> and <emph>y</emph> translations (offsets) of a
-region area with respect to the nominal (untranslated) origin of the region.</p>
-<p>This attribute may be specified by any element type
-that permits use of attributes in the TT Style Namespace; however, this attribute applies
-as a style property only to those element types indicated in the following table.</p>
-<table id="style-property-details-translate" role="common">
-<col width="25%"/>
-<col/>
-<tbody>
-<tr>
-<td><emph>Values:</emph></td>
-<td>
-<loc href="#style-value-length">&lt;length&gt;</loc> <loc href="#style-value-length">&lt;length&gt;</loc>
-</td>
-</tr>
-<tr>
-<td><emph>Initial:</emph></td>
-<td><code>0px 0px</code></td>
-</tr>
-<tr>
-<td><emph>Applies to:</emph></td>
-<td>
-<loc href="#content-vocabulary-div"><el>div</el></loc>,
-<loc href="#content-vocabulary-p"><el>p</el></loc>,
-<loc href="#layout-vocabulary-region"><el>region</el></loc>
-</td>
-</tr>
-<tr>
-<td><emph>Inherited:</emph></td>
-<td>no</td>
-</tr>
-<tr>
-<td><emph>Percentages:</emph></td>
-<td>relative to width and height of <loc href="#terms-root-container-region">root container region</loc></td>
-</tr>
-<tr>
-<td><emph>Animatable:</emph></td>
-<td>discrete, continuous</td>
-</tr>
-</tbody>
-</table>
-<p>If the value of this attribute consists of two <loc href="#style-value-length">&lt;length&gt;</loc> specifications,
-then they must be interpreted as <emph>x</emph> and <emph>y</emph> offsets, where the first specification
-is the <emph>x</emph> offset, and the second specification is the <emph>y</emph> offset, and where positive values mean to the right or bottom of the affected
-region, respectively</p>
-<p>If a <att>tts:translate</att> attribute is specified on a <el>div</el> or <el>p</el> element, then that specification must be considered to be
-equivalent to specifying an anonymous <loc href="#terms-inline-region">inline region</loc> child of the <el>div</el> or <el>p</el> element, where the
-translation of the corresponding region, also referred to as an <loc href="#terms-implied-inline-region">implied inline region</loc>, is equal to the
-value of this attribute.</p>
-<p>If a computed value of the property associated with this attribute is not supported,
-then a <loc href="#terms-presentation-processor">presentation processor</loc> must use the closest supported value.</p>
-<note role="elaboration">
-<p>In this context, the phrase <emph>closest supported value</emph> means the value for which the Euclidean distance between
-the computed translate and the supported translate is minimized. If there are multiple closest supported values equally distant from
-the computed value, then the value least distant from [0,0], i.e., closest to the coordinate space origin, is used.</p>
-</note>
-<p>The <att>tts:translate</att> style is illustrated by the following example which conditionally applies a negative (leftward) or
-positive (rightward) translation in the X axis, depending upon whether a left or right image of a steroscopic presentation is being rendered.</p>
-<table id="style-attribute-translate-example-1" role="example">
-<caption>Example Fragment &ndash; Translate</caption>
-<tbody>
-<tr>
-<td>
-<eg xml:space="preserve">
-&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="-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;
-  3D Text Sample
-&lt;/p&gt;
-</eg>
-</td>
-</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>
-<date>2015-01-17</date>
-<edtext>Insert example image of tts:translate.</edtext>
-</ednote>
-</div3>
 <div3 id="style-attribute-unicodeBidi">
 <head>tts:unicodeBidi</head>
 <p>The <att>tts:unicodeBidi</att> attribute is used to specify a style property that
--- a/ttml2/spec/xsd/ttml2-datatypes.xsd	Sun Jan 25 13:58:30 2015 -0700
+++ b/ttml2/spec/xsd/ttml2-datatypes.xsd	Sun Jan 25 14:46:52 2015 -0700
@@ -101,6 +101,12 @@
       <xs:enumeration value="rtl"/>
     </xs:restriction>
   </xs:simpleType>
+  <xs:simpleType name="disparity">
+    <xs:annotation>
+      <xs:documentation>length</xs:documentation>
+    </xs:annotation>
+    <xs:restriction base="xs:string"/>
+  </xs:simpleType>
   <xs:simpleType name="display">
     <xs:restriction base="xs:token">
       <xs:enumeration value="auto"/>
@@ -695,12 +701,6 @@
     </xs:annotation>
     <xs:restriction base="xs:string"/>
   </xs:simpleType>
-  <xs:simpleType name="translate">
-    <xs:annotation>
-      <xs:documentation>length length</xs:documentation>
-    </xs:annotation>
-    <xs:restriction base="xs:string"/>
-  </xs:simpleType>
   <xs:simpleType name="unicodeBidi">
     <xs:restriction base="xs:token">
       <xs:enumeration value="normal"/>
--- a/ttml2/spec/xsd/ttml2-styling-attribs.xsd	Sun Jan 25 13:58:30 2015 -0700
+++ b/ttml2/spec/xsd/ttml2-styling-attribs.xsd	Sun Jan 25 14:46:52 2015 -0700
@@ -12,6 +12,7 @@
   <xs:attribute name="border" type="ttd:border"/>
   <xs:attribute name="color" type="ttd:color"/>
   <xs:attribute name="direction" type="ttd:direction"/>
+  <xs:attribute name="disparity" type="ttd:disparity"/>
   <xs:attribute name="display" type="ttd:display"/>
   <xs:attribute name="displayAlign" type="ttd:displayAlign"/>
   <xs:attribute name="extent" type="ttd:extent"/>
@@ -42,7 +43,6 @@
   <xs:attribute name="textOrientation" type="ttd:textOrientation"/>
   <xs:attribute name="textOutline" type="ttd:textOutline"/>
   <xs:attribute name="textShadow" type="ttd:textShadow"/>
-  <xs:attribute name="translate" type="ttd:translate"/>
   <xs:attribute name="unicodeBidi" type="ttd:unicodeBidi"/>
   <xs:attribute name="visibility" type="ttd:visibility"/>
   <xs:attribute name="width" type="ttd:measure"/>
@@ -57,6 +57,7 @@
     <xs:attribute ref="tts:border"/>
     <xs:attribute ref="tts:color"/>
     <xs:attribute ref="tts:direction"/>
+    <xs:attribute ref="tts:disparity"/>
     <xs:attribute ref="tts:display"/>
     <xs:attribute ref="tts:displayAlign"/>
     <xs:attribute ref="tts:extent"/>
@@ -87,7 +88,6 @@
     <xs:attribute ref="tts:textOrientation"/>
     <xs:attribute ref="tts:textOutline"/>
     <xs:attribute ref="tts:textShadow"/>
-    <xs:attribute ref="tts:translate"/>
     <xs:attribute ref="tts:unicodeBidi"/>
     <xs:attribute ref="tts:visibility"/>
     <xs:attribute ref="tts:width"/>