[ttml2] address ISSUE-224 issue-224
authorplemieux
Mon, 26 Oct 2015 17:11:21 -0700
branchissue-224
changeset 984 19905fe73a06
parent 983 2449f7f32aa0
[ttml2] address ISSUE-224
ttml2/spec/images/disparity1.png
ttml2/spec/ttml2.xml
Binary file ttml2/spec/images/disparity1.png has changed
--- a/ttml2/spec/ttml2.xml	Fri Oct 16 07:31:22 2015 -0700
+++ b/ttml2/spec/ttml2.xml	Mon Oct 26 17:11:21 2015 -0700
@@ -8186,7 +8186,9 @@
 <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>
+in order to simulate stereopsis (stereoscopic depth).  A disparity of zero corresponds to the plane of display; a negative value corresponds to depths in front
+ of the plane of display; and a positive value corresponds to depths behind the plane of display. See <bibref ref="smiththreed"/>
+ for details on the relationship between disparity and perceived 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>
@@ -8226,8 +8228,9 @@
 </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>When rendering a region on the right image of a stereoscopic image pair, the center of the region shall be offset along the horizontal axis by a value equal to ½ the computed value of <att>tts:disparity</att>; when rendering a region on the left image of a stereoscopic image pair, the center of the region shall be offset along the horizontal axis by a value equal to -½ the computed value of <att>tts:disparity</att>.</p>
+<p><att>tts:disparity</att> is ignored unless rendering onto a stereoscopic image pair.</p>
+<p>The author should ensure that the perceived depth of a region is positioned in front of any object in the scene during the entire time the region is visible. The stereoscopic effect will be broken if an object in the scene is perceived to be in front of the region.</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
@@ -8243,7 +8246,7 @@
 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>
+<p>The <att>tts:disparity</att> style is illustrated by the following example fragment and rendition. Note that, in typical television scenarios, disparity ranges from -1% to 2% of screen width. This example, which uses a disparity of 5%, exaggerates the effects of disparity for clarity of illustration.</p>
 <table id="style-attribute-disparity-example-1" role="example">
 <caption>Example Fragment &ndash; Disparity</caption>
 <tbody>
@@ -8251,13 +8254,14 @@
 <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;style tts:extent="80% 10%"/&gt;
+  &lt;style tts:origin="10% 10%"/&gt;
+  &lt;style <phrase role="strong">tts:disparity="5%"</phrase>/&gt;
+	...
 &lt;/region&gt;
 ...
 &lt;p region="r1"&gt;
-  3D Text Sample
+  Stereoscopic
 &lt;/p&gt;
 </eg>
 </td>
@@ -8265,11 +8269,14 @@
 </tbody>
 </table>
 <p></p>
-<ednote>
-<name>Disparity Example</name>
-<date>2015-01-17</date>
-<edtext>Insert example image of tts:disparity.</edtext>
-</ednote>
+<table id="style-attribute-disparity-example-1-images" role="example-images">
+<caption>Example Rendition &ndash; Disparity (Left and Right images of a stereoscopic pair)</caption>
+<tbody>
+<tr>
+<td><graphic source="images/disparity1.png" alt="TTML disparity style property"/></td>
+</tr>
+</tbody>
+</table>
 </div3>
 <div3 id="style-attribute-display">
 <head>tts:display</head>
@@ -20514,6 +20521,9 @@
 United States Code of Federal Regulations, Title 47, Volume 1, Part 79, &sect; 79.101. (See
 <xspecref href="http://www.gpo.gov/fdsys/pkg/CFR-2012-title47-vol4/pdf/CFR-2012-title47-vol4-sec79-101.pdf">http://www.gpo.gov/fdsys/pkg/CFR-2012-title47-vol4/pdf/CFR-2012-title47-vol4-sec79-101.pdf</xspecref>.)
 </bibl>
+<bibl id="smiththreed" key="SMITH">Smith, Michael D.; Malia, Jason, <titleref
+href="http://ieeexplore.ieee.org/stamp/stamp.jsp?tp=&amp;arnumber=7271939&amp;isnumber=7271882">Controlling Miniaturization in Stereoscopic 3D Imagery</titleref>, in Motion Imaging Journal, SMPTE , vol.124, no.3, pp.50-58, April 2015 doi: 10.5594/j18531
+</bibl>
 <bibl id="cea608e" key="CEA-608-E">
 EIA/CEA-608-E,
 <titleref href="http://www.ce.org/">Line 21 Data