W3C home > Mailing lists > Public > public-css-commits@w3.org > July 2011

csswg/css3-speech Overview.html,1.81,1.82 Overview.src.html,1.82,1.83

From: Daniel Weck via cvs-syncmail <cvsmail@w3.org>
Date: Wed, 13 Jul 2011 22:48:31 +0000
To: public-css-commits@w3.org
Message-Id: <E1Qh8EJ-0007Xk-Mc@lionel-hutz.w3.org>
Update of /sources/public/csswg/css3-speech
In directory hutz:/tmp/cvs-serv28911

Modified Files:
	Overview.html Overview.src.html 
Log Message:
voice-rate "computed value" fix, made consistent with voice-volume by allowing combination of keyword and percentage, added example.


Index: Overview.html
===================================================================
RCS file: /sources/public/csswg/css3-speech/Overview.html,v
retrieving revision 1.81
retrieving revision 1.82
diff -u -d -r1.81 -r1.82
--- Overview.html	13 Jul 2011 22:12:17 -0000	1.81
+++ Overview.html	13 Jul 2011 22:48:29 -0000	1.82
@@ -548,7 +548,7 @@
     <tr>
      <td> <em>Computed value:</em>
 
-     <td>keyword value, and decibel offset (if not zero)
+     <td>a keyword value, and optionally also a decibel offset (if not zero)
   </table>
 
   <p>The &lsquo;<a href="#voice-volume"><code
@@ -618,15 +618,16 @@
      (decibel unit). This represents a change (positive or negative) relative
      to the given keyword value (see enumeration above), or to the default
      value for the root element, or otherwise to the inherited volume level
-     (which may itself be be a combination of a keyword value and of a
-     decibel offset). When the inherited volume level is &lsquo;<code
+     (which may itself be a combination of a keyword value and of a decibel
+     offset, in which case the decibel values are combined additively). When
+     the inherited volume level is &lsquo;<code
      class=property>silent</code>&rsquo;, this &lsquo;<a
      href="#voice-volume"><code class=property>voice-volume</code></a>&rsquo;
      resolves to &lsquo;<code class=property>silent</code>&rsquo; too,
-     regardless of the specified &lt;decibel&gt; value. Decibels express the
-     ratio of the squares of the new signal amplitude (a1) and the current
-     amplitude (a0), as per the following logarithmic equation: volume(dB) =
-     20 log10 (a1 / a0)</p>
+     regardless of the specified &lt;decibel&gt; value. Decibels represent
+     the ratio of the squares of the new signal amplitude (a1) and the
+     current amplitude (a0), as per the following logarithmic equation:
+     volume(dB) = 20 log10 (a1 / a0)</p>
 
     <p class=note> Note that -6.0dB is approximately half the amplitude of
      the audio signal, and +6.0dB is approximately twice the amplitude.</p>
@@ -691,7 +692,9 @@
     <tr>
      <td> <em>Computed value:</em>
 
-     <td>specified value
+     <td>the specified value resolved to a &lt;number&gt; between
+      &lsquo;<code class=css>-100</code>&rsquo; and &lsquo;<code
+      class=css>100</code>&rsquo; (inclusive)
   </table>
 
   <p> The &lsquo;<a href="#voice-balance"><code
@@ -2033,8 +2036,8 @@
     <tr>
      <td> <em>Value:</em>
 
-     <td>normal | &lt;percentage&gt; | x-slow | slow | medium | fast | x-fast
-      
+     <td>[normal | x-slow | slow | medium | fast | x-fast] ||
+      &lt;percentage&gt;
 
     <tr>
      <td> <em>Initial:</em>
@@ -2064,7 +2067,8 @@
     <tr>
      <td> <em>Computed value:</em>
 
-     <td>specified value
+     <td>a keyword value, and optionally also a percentage relative to the
+      keyword (if not 100%)
   </table>
 
   <p>The &lsquo;<a href="#voice-rate"><code
@@ -2085,26 +2089,69 @@
      currently active voice. This is processor-specific and depends on the
      language, dialect and on the "personality" of the voice.</p>
 
-   <dt> <strong>&lt;percentage&gt;</strong>
-
-   <dd>
-    <p>Only non-negative <a href="#percentage-def">percentage</a> values are
-     allowed. Computed values are calculated relative to the default speaking
-     rate for the voice (the "normal" computed value). For example, 50% means
-     that the default value gets multiplied by 0.5, which results in half the
-     default rate of the voice.</p>
-
    <dt><strong>x-slow</strong>, <strong>slow</strong>,
     <strong>medium</strong>, <strong>fast</strong> and
     <strong>x-fast</strong>
 
    <dd>
     <p>A sequence of monotonically non-decreasing speaking rates that are
-     implementation and voice specific. For example, typical values for the
+     implementation and voice -specific. For example, typical values for the
      English language are (in words per minute) x-slow = 80, slow = 120,
      medium = between 180 and 200, fast = 500.</p>
+
+   <dt> <strong>&lt;percentage&gt;</strong>
+
+   <dd>
+    <p>Only non-negative <a href="#percentage-def">percentage</a> values are
+     allowed. This represents a change relative to the given keyword value
+     (see enumeration above), or to the default value for the root element,
+     or otherwise to the inherited speaking rate (which may itself be a
+     combination of a keyword value and of a percentage, in which case
+     percentages are combined multiplicatively). For example, 50% means that
+     the speaking rate gets multiplied by 0.5 (half the value).</p>
   </dl>
 
+  <div class=example>
+   <p>Examples of inherited values:</p>
+
+   <pre>
+&lt;body&gt;
+  &lt;e1&gt;
+    &lt;e2&gt;
+      &lt;e3&gt;
+        ...
+      &lt;/e3&gt;
+    &lt;/e2&gt;
+  &lt;/e1&gt;
+&lt;/body&gt;
+
+
+
+
+body { voice-rate: inherit; } /* the initial value is 'normal'
+                               (the actual speaking rate value
+                               depends on the active voice) */
+
+e1 { voice-rate: +50%; } /* the computed value is
+                          ['normal' and 50%], which will resolve
+                          to the rate corresponding to 'normal'
+                          multiplied by 0.5 (half the speaking rate) */
+
+e2 { voice-rate: fast 120%; } /* the computed value is
+                          ['fast' and 120%], which will resolve
+                          to the rate corresponding to 'fast'
+                          multiplied by 1.2 (one and a half times the speaking rate) */
+                          
+e3 { voice-rate: normal; /* "resets" the speaking rate to the intrinsic voice value,
+                            the computed value is 'normal' (see comment below for actual value) */
+                           
+     voice-family: "another-voice"; } /* because the voice is different,
+                                      the calculated speaking rate may vary
+                                      compared to "body" (even though the computed
+                                      'voice-rate' value is the same) */
+      </pre>
+  </div>
+
   <h3 id=voice-props-voice-pitch><span class=secno>10.3. </span>The &lsquo;<a
    href="#voice-pitch"><code class=property>voice-pitch</code></a>&rsquo;
    property</h3>
@@ -2152,7 +2199,7 @@
 
      <td>an absolute frequency, or a keyword value and potentially also a
       frequency, semitone, and/or percentage representing any non-zero
-      offsets
+      offsets (relative to the keyword)
   </table>
 
   <p>The &lsquo;<a href="#voice-pitch"><code
@@ -2294,7 +2341,7 @@
 
      <td>an absolute frequency, or a keyword value and potentially also a
       frequency, semitone, and/or percentage representing any non-zero
-      offsets
+      offsets (relative to the keyword)
   </table>
 
   <p> The &lsquo;<a href="#voice-range"><code
@@ -3098,7 +3145,8 @@
     <tr>
      <td><a class=property href="#voice-rate">voice-rate</a>
 
-     <td>normal | &lt;percentage&gt; | x-slow | slow | medium | fast | x-fast
+     <td>[normal | x-slow | slow | medium | fast | x-fast] ||
+      &lt;percentage&gt;
 
      <td>normal
 
@@ -3634,6 +3682,12 @@
    <li>Added the &lsquo;<code class=property>normal</code>&rsquo; value for
     voice-rate ("default" in SSML 1.1).
 
+   <li>Fixed the "computed value" for voice-rate, and added the possibility
+    to combine keywords and percentages (to be consistent with &lsquo;<a
+    href="#voice-volume"><code
+    class=property>voice-volume</code></a>&rsquo;). Added an example to
+    illustrate inheritance and value resolution.
+
    <li>Renamed voice-family fields to be consistent with SSML.
 
    <li>Improved the &lsquo;<a href="#voice-family"><code

Index: Overview.src.html
===================================================================
RCS file: /sources/public/csswg/css3-speech/Overview.src.html,v
retrieving revision 1.82
retrieving revision 1.83
diff -u -d -r1.82 -r1.83
--- Overview.src.html	13 Jul 2011 22:12:17 -0000	1.82
+++ Overview.src.html	13 Jul 2011 22:48:29 -0000	1.83
@@ -292,7 +292,7 @@
           <td>
             <em>Computed value:</em>
           </td>
-          <td>keyword value, and decibel offset (if not zero)</td>
+          <td>a keyword value, and optionally also a decibel offset (if not zero)</td>
         </tr>
       </tbody>
     </table>
@@ -342,11 +342,12 @@
         <p>A <a href="#number-def">number</a> immediately followed by "dB" (decibel unit). This
           represents a change (positive or negative) relative to the given keyword value (see
           enumeration above), or to the default value for the root element, or otherwise to the
-          inherited volume level (which may itself be be a combination of a keyword value and of a
-          decibel offset). When the inherited volume level is 'silent', this 'voice-volume' resolves
-          to 'silent' too, regardless of the specified &lt;decibel&gt; value. Decibels express the
-          ratio of the squares of the new signal amplitude (a1) and the current amplitude (a0), as
-          per the following logarithmic equation: volume(dB) = 20 log10 (a1 / a0) </p>
+          inherited volume level (which may itself be a combination of a keyword value and of a
+          decibel offset, in which case the decibel values are combined additively). When the
+          inherited volume level is 'silent', this 'voice-volume' resolves to 'silent' too,
+          regardless of the specified &lt;decibel&gt; value. Decibels represent the ratio of the
+          squares of the new signal amplitude (a1) and the current amplitude (a0), as per the
+          following logarithmic equation: volume(dB) = 20 log10 (a1 / a0) </p>
         <p class="note"> Note that -6.0dB is approximately half the amplitude of the audio signal,
           and +6.0dB is approximately twice the amplitude.</p>
       </dd>
@@ -408,7 +409,8 @@
           <td>
             <em>Computed value:</em>
           </td>
-          <td>specified value</td>
+          <td>the specified value resolved to a &lt;number&gt; between '-100' and '100'
+            (inclusive)</td>
         </tr>
       </tbody>
     </table>
@@ -1582,7 +1584,7 @@
           <td>
             <em>Value:</em>
           </td>
-          <td>normal | &lt;percentage&gt; | x-slow | slow | medium | fast | x-fast </td>
+          <td>[normal | x-slow | slow | medium | fast | x-fast] || &lt;percentage&gt;</td>
         </tr>
         <tr>
           <td>
@@ -1618,7 +1620,8 @@
           <td>
             <em>Computed value:</em>
           </td>
-          <td>specified value</td>
+          <td>a keyword value, and optionally also a percentage relative to the keyword (if not
+            100%)</td>
         </tr>
       </tbody>
     </table>
@@ -1636,23 +1639,66 @@
           voice. This is processor-specific and depends on the language, dialect and on the
           "personality" of the voice. </p>
       </dd>
-      <dt>
-        <strong>&lt;percentage&gt;</strong>
-      </dt>
-      <dd>
-        <p>Only non-negative <a href="#percentage-def">percentage</a> values are allowed. Computed
-          values are calculated relative to the default speaking rate for the voice (the "normal"
-          computed value). For example, 50% means that the default value gets multiplied by 0.5,
-          which results in half the default rate of the voice.</p>
-      </dd>
       <dt><strong>x-slow</strong>, <strong>slow</strong>, <strong>medium</strong>,
           <strong>fast</strong> and <strong>x-fast</strong></dt>
       <dd>
         <p>A sequence of monotonically non-decreasing speaking rates that are implementation and
-          voice specific. For example, typical values for the English language are (in words per
+          voice -specific. For example, typical values for the English language are (in words per
           minute) x-slow = 80, slow = 120, medium = between 180 and 200, fast = 500. </p>
       </dd>
+      <dt>
+        <strong>&lt;percentage&gt;</strong>
+      </dt>
+      <dd>
+        <p>Only non-negative <a href="#percentage-def">percentage</a> values are allowed. This
+          represents a change relative to the given keyword value (see enumeration above), or to the
+          default value for the root element, or otherwise to the inherited speaking rate (which may
+          itself be a combination of a keyword value and of a percentage, in which case percentages
+          are combined multiplicatively). For example, 50% means that the speaking rate gets
+          multiplied by 0.5 (half the value).</p>
+      </dd>
     </dl>
+
+    <div class="example">
+      <p>Examples of inherited values:</p>
+      <pre>
+&lt;body&gt;
+  &lt;e1&gt;
+    &lt;e2&gt;
+      &lt;e3&gt;
+        ...
+      &lt;/e3&gt;
+    &lt;/e2&gt;
+  &lt;/e1&gt;
+&lt;/body&gt;
+
+
+
+
+body { voice-rate: inherit; } /* the initial value is 'normal'
+                               (the actual speaking rate value
+                               depends on the active voice) */
+
+e1 { voice-rate: +50%; } /* the computed value is
+                          ['normal' and 50%], which will resolve
+                          to the rate corresponding to 'normal'
+                          multiplied by 0.5 (half the speaking rate) */
+
+e2 { voice-rate: fast 120%; } /* the computed value is
+                          ['fast' and 120%], which will resolve
+                          to the rate corresponding to 'fast'
+                          multiplied by 1.2 (one and a half times the speaking rate) */
+                          
+e3 { voice-rate: normal; /* "resets" the speaking rate to the intrinsic voice value,
+                            the computed value is 'normal' (see comment below for actual value) */
+                           
+     voice-family: "another-voice"; } /* because the voice is different,
+                                      the calculated speaking rate may vary
+                                      compared to "body" (even though the computed
+                                      'voice-rate' value is the same) */
+      </pre>
+    </div>
+
     <h3 id="voice-props-voice-pitch">The 'voice-pitch' property</h3>
     <table class="propdef" summary="name: syntax">
       <tbody>
@@ -1704,7 +1750,7 @@
             <em>Computed value:</em>
           </td>
           <td>an absolute frequency, or a keyword value and potentially also a frequency, semitone,
-            and/or percentage representing any non-zero offsets </td>
+            and/or percentage representing any non-zero offsets (relative to the keyword)</td>
         </tr>
       </tbody>
     </table>
@@ -1839,7 +1885,7 @@
             <em>Computed value:</em>
           </td>
           <td>an absolute frequency, or a keyword value and potentially also a frequency, semitone,
-            and/or percentage representing any non-zero offsets </td>
+            and/or percentage representing any non-zero offsets (relative to the keyword) </td>
         </tr>
       </tbody>
     </table>
@@ -2568,6 +2614,9 @@
         axis and three-dimensional sound stage (azimuth support in future versions of
         CSS-Speech).</li>
       <li>Added the 'normal' value for voice-rate ("default" in SSML 1.1).</li>
+      <li>Fixed the "computed value" for voice-rate, and added the possibility to combine keywords
+        and percentages (to be consistent with 'voice-volume'). Added an example to illustrate
+        inheritance and value resolution.</li>
       <li>Renamed voice-family fields to be consistent with SSML.</li>
       <li>Improved the 'voice-family' selection algorithm to cater for language changes.</li>
       <li>Separated definition of semitones (pitch properties).</li>
Received on Wednesday, 13 July 2011 22:48:38 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Wednesday, 13 July 2011 22:48:39 GMT