Address #276

* Remove visual.text from daptm:scriptRepresents when it is not used * Add and describe a new example demonstrating the use of content descriptor sub-type, and how langSrc is set when the transcript reflects visual text.
w3c · Dec 10, 2024 · a0056fa · a0056fa
1 parent 3e51f2a
commit a0056fa
Show file tree

Hide file tree

Showing 4 changed files with 50 additions and 2 deletions.
diff --git a/examples/intro-script-with-gain.xml b/examples/intro-script-with-gain.xml
@@ -1,5 +1,5 @@
 <tt ...
-  daptm:scriptRepresents="visual.nonText visual.text"
+  daptm:scriptRepresents="visual.nonText"
   daptm:scriptType="asRecorded"
   xml:lang="en"
   daptm:langSrc="">

diff --git a/examples/intro-times-and-text-with-visual-text.xml b/examples/intro-times-and-text-with-visual-text.xml
@@ -0,0 +1,30 @@
+<tt xmlns="http://www.w3.org/ns/ttml"
+  xmlns:ttp="http://www.w3.org/ns/ttml#parameter"
+  xmlns:daptm="http://www.w3.org/ns/ttml/profile/dapt#metadata"
+  xmlns:xml="http://www.w3.org/XML/1998/namespace"
+  ttp:contentProfiles="http://www.w3.org/ns/ttml/profile/dapt1.0/content"
+  xml:lang="en"
+  daptm:langSrc=""
+  daptm:scriptRepresents="visual.nonText visual.text"
+  daptm:scriptType="preRecording">
+  <body>
+    <div begin="7s" end="8.5s" xml:id="at1"
+         daptm:represents="visual.text.location" daptm:langSrc="en">
+      <p>
+        The Lake District, England
+      </p>
+    </div>
+    <div begin="10s" end="13s" xml:id="a1"
+         daptm:represents="visual.nonText">
+      <p>
+        A woman climbs into a small sailing boat.
+      </p>
+    </div>
+    <div begin="18s" end="20s" xml:id="a2"
+         daptm:represents="visual.nonText">
+      <p>
+        The woman pulls the tiller and the boat turns.
+      </p>
+    </div>
+  </body>
+</tt>
diff --git a/examples/intro-times-and-text.xml b/examples/intro-times-and-text.xml
@@ -5,7 +5,7 @@
   ttp:contentProfiles="http://www.w3.org/ns/ttml/profile/dapt1.0/content"
   xml:lang="en"
   daptm:langSrc=""
-  daptm:scriptRepresents="visual.nonText visual.text"
+  daptm:scriptRepresents="visual.nonText"
   daptm:scriptType="preRecording">
   <body>
     <div begin="10s" end="13s" xml:id="a1" daptm:represents="visual.nonText">

diff --git a/index.html b/index.html
@@ -470,6 +470,24 @@ <h4>Audio Description Examples</h4>
           data-include="examples/intro-times-and-text.xml"
           data-include-format="text">
         </pre>
+        <p>Audio description content often includes text present in the visual image,
+          for example if the image contains a written sign, a location, etc.
+          The following example demonstrates such a case:
+          <a>Script Represents</a> is extended
+          to show that the <a>script</a>'s contents represent textual visual information
+          in addition to non-textual visual information.
+          Here a more precise value of <a>Represents</a>
+          is specified on the <a>Script Event</a>
+          to reflect that the text is in fact a location,
+          which is allowed because the more precise value is a <a>sub-type</a>
+          of the new value in <a>Script Represents</a>.
+          Finally, since the text has an inherent language, the <a>Text Language Source</a>
+          is set to reflect that language. 
+        </p>
+        <pre class="example"
+          data-include="examples/intro-times-and-text-with-visual-text.xml"
+          data-include-format="text">
+        </pre>
         <p>After creating audio recordings, if not using text to speech, instructions for playback
           mixing can be inserted. For example, The gain of "received" audio can be changed before mixing in
           the audio played from inside the <code>&lt;span&gt;</code> element, smoothly