updated computed value definition, and inheritance example

Author: danielweck

css3-speech/Overview.html

@@ -2150,8 +2150,9 @@ <h3 id=voice-props-voice-pitch><span class=secno>10.3. </span>The &lsquo;<a
     <tr>
      <td> <em>Computed value:</em>
 
-     <td>an absolute frequency or keyword value, and potentially, a
-      frequency, semitone, or percentage representing any non-zero offsets
+     <td>an absolute frequency, or a keyword value and potentially also a
+      frequency, semitone, and/or percentage representing any non-zero
+      offsets
   </table>
 
   <p>The &lsquo;<a href="#voice-pitch"><code
@@ -2176,10 +2177,10 @@ <h3 id=voice-props-voice-pitch><span class=secno>10.3. </span>The &lsquo;<a
     <p> A value in <a href="#frequency-def">frequency</a> units (Hertz or
      kiloHertz, e.g. "100Hz", "+2kHz"). Values are restricted to positive
      numbers when the &lsquo;<code class=property>absolute</code>&rsquo;
-     keyword is used. Otherwise (when the &lsquo;<code
-     class=property>absolute</code>&rsquo; keyword is not used), a negative
-     value represents an decrement, and a positive value represents an
-     increment (relative to the inherited value). For example, "2kHz" is a
+     keyword is specified. Otherwise (when the &lsquo;<code
+     class=property>absolute</code>&rsquo; keyword is not specified), a
+     negative value represents a decrement, and a positive value represents
+     an increment, relative to the inherited value. For example, "2kHz" is a
      positive offset (strictly equivalent to "+2kHz"), and "+2kHz absolute"
      is an absolute frequency (strictly equivalent to "2kHz absolute").</p>
 
@@ -2291,8 +2292,9 @@ <h3 id=voice-props-voice-range><span class=secno>10.4. </span>The &lsquo;<a
     <tr>
      <td> <em>Computed value:</em>
 
-     <td>an absolute frequency or keyword value, and potentially, a
-      frequency, semitone, or percentage representing any non-zero offsets
+     <td>an absolute frequency, or a keyword value and potentially also a
+      frequency, semitone, and/or percentage representing any non-zero
+      offsets
   </table>
 
   <p> The &lsquo;<a href="#voice-range"><code
@@ -2317,10 +2319,10 @@ <h3 id=voice-props-voice-range><span class=secno>10.4. </span>The &lsquo;<a
     <p> A value in <a href="#frequency-def">frequency</a> units (Hertz or
      kiloHertz, e.g. "100Hz", "+2kHz"). Values are restricted to positive
      numbers when the &lsquo;<code class=property>absolute</code>&rsquo;
-     keyword is used. Otherwise (when the &lsquo;<code
-     class=property>absolute</code>&rsquo; keyword is not used), a negative
-     value represents an decrement, and a positive value represents an
-     increment (relative to the inherited value). For example, "2kHz" is a
+     keyword is specified. Otherwise (when the &lsquo;<code
+     class=property>absolute</code>&rsquo; keyword is not specified), a
+     negative value represents a decrement, and a positive value represents
+     an increment, relative to the inherited value. For example, "2kHz" is a
      positive offset (strictly equivalent to "+2kHz"), and "+2kHz absolute"
      is an absolute frequency (strictly equivalent to "2kHz absolute").</p>
 
@@ -2340,8 +2342,7 @@ <h3 id=voice-props-voice-range><span class=secno>10.4. </span>The &lsquo;<a
      (semitones). A semitone is half of a tone (a half step) on the standard
      diatonic scale. As such, a semitone doesn't correspond to a fixed
      frequency: the ratio between two consecutive frequencies separated by
-     exactly one semitone is the twelfth root of two (approximately 1.05946).
-     </p>
+     exactly one semitone is the twelfth root of two (approximately 1.05946).</p>
 
    <dt> <strong>&lt;percentage&gt;</strong>
 
@@ -2350,17 +2351,17 @@ <h3 id=voice-props-voice-range><span class=secno>10.4. </span>The &lsquo;<a
      are allowed, to represent an increment or decrement (respectively)
      relative to the inherited value. Computed values are calculated by
      adding (or subtracting) the specified fraction of the inherited value,
-     to (from) the inherited frequency value. For example, 50% (which is
-     equivalent to +50%) with a inherited value of 200Hz results in <code>200
-     + (200*0.5)</code> = 300Hz. Conversely, -50% results in
+     to (from) the inherited value. For example, 50% (which is equivalent to
+     +50%) with a inherited value of 200Hz results in <code>200 +
+     (200*0.5)</code> = 300Hz. Conversely, -50% results in
      <code>200-(200*0.5)</code> = 100Hz.</p>
 
    <dt><strong>x-low</strong>, <strong>low</strong>, <strong>medium</strong>,
-    <strong>high</strong> and <strong>x-high</strong>
+    <strong>high</strong>, <strong>x-high</strong>
 
    <dd>
-    <p>A sequence of monotonically non-decreasing pitch ranges that are
-     implementation and language-dependent.</p>
+    <p>A sequence of monotonically non-decreasing pitch levels that are
+     implementation and voice specific.</p>
   </dl>
 
   <p> Computed absolute frequency values that are negative are clamped to
@@ -2377,24 +2378,52 @@ <h3 id=voice-props-voice-range><span class=secno>10.4. </span>The &lsquo;<a
 
    <pre>
 &lt;body&gt;
-  &lt;parent&gt;
-    &lt;child&gt;
-      &lt;grandchild&gt;
-      ...
-      &lt;/grandchild&gt;
-    &lt;/child&gt;
-  &lt;/parent&gt;
-&lt;/body&gt; 
-        
-body { voice-range: inherit; } /* the initial value is 'medium' */
-parent { voice-range: 200Hz absolute; } /* override with an absolute frequency */
-child { voice-range: 2st; } /* the computed value is [200Hz + two semitones] */
-grandchild { voice-range: inherit;
-             voice-family: "another-voice"; } /* the computed value is the same as
-                              for "child", but the voice is different so the
-                              calculated (used) absolute frequency
-                              may be completely different,
+  &lt;e1&gt;
+    &lt;e2&gt;
+      &lt;e3&gt;
+        &lt;e4&gt;
+          &lt;e5&gt;
+          ...
+          &lt;/e5&gt;
+        &lt;/e4&gt;
+      &lt;/e3&gt;
+    &lt;/e2&gt;
+  &lt;/e1&gt;
+&lt;/body&gt;
+
+
+
+
+body { voice-range: inherit; } /* the initial value is 'medium'
+                               (the actual frequency value
+                               depends on the active voice) */
+
+e1 { voice-range: +25%; } /* the computed value is
+                          ['medium' + 0.25 times the frequency
+                          corresponding to 'medium'] */
+
+e2 { voice-range: inherit; /* this could be omitted,
+                           but we explicitly specify it for clarity purposes */
+                           
+     voice-family: "another-voice"; } /* the computed value is the same as
+                              for "e1", but here the voice is different,
+                              so once calculated, the used absolute frequency
+                              may be completely different
                               due to voice-dependent discrepancies */
+
+e3 { voice-range: 200Hz absolute; } /* override with an absolute frequency
+                                    which doesn't depend on the active voice */
+
+e4 { voice-range: 2st; } /* the computed value is an absolute frequency,
+                         which is the result of the
+                         calculation: 200Hz + two semitones */
+
+e5 { voice-range: inherit; /* this could be omitted,
+                           but we explicitly specify it for clarity purposes */
+                           
+     voice-family: "yet-another-voice"; } /* the computed value is the same as
+                              for "e4" (i.e. an absolute frequency value,
+                              independent from the active voice) */
       </pre>
   </div>
 

css3-speech/Overview.src.html

@@ -1703,8 +1703,8 @@ <h3 id="voice-props-voice-pitch">The 'voice-pitch' property</h3>
           <td>
             <em>Computed value:</em>
           </td>
-          <td>an absolute frequency or keyword value, and potentially, a frequency, semitone, or
-            percentage representing any non-zero offsets </td>
+          <td>an absolute frequency, or a keyword value and potentially also a frequency, semitone,
+            and/or percentage representing any non-zero offsets </td>
         </tr>
       </tbody>
     </table>
@@ -1724,10 +1724,11 @@ <h3 id="voice-props-voice-pitch">The 'voice-pitch' property</h3>
       <dd>
         <p> A value in <a href="#frequency-def">frequency</a> units (Hertz or kiloHertz, e.g.
           "100Hz", "+2kHz"). Values are restricted to positive numbers when the 'absolute' keyword
-          is used. Otherwise (when the 'absolute' keyword is not used), a negative value represents
-          an decrement, and a positive value represents an increment (relative to the inherited
-          value). For example, "2kHz" is a positive offset (strictly equivalent to "+2kHz"), and
-          "+2kHz absolute" is an absolute frequency (strictly equivalent to "2kHz absolute"). </p>
+          is specified. Otherwise (when the 'absolute' keyword is not specified), a negative value
+          represents a decrement, and a positive value represents an increment, relative to the
+          inherited value. For example, "2kHz" is a positive offset (strictly equivalent to
+          "+2kHz"), and "+2kHz absolute" is an absolute frequency (strictly equivalent to "2kHz
+          absolute"). </p>
       </dd>
       <dt>
         <strong>absolute</strong>
@@ -1837,8 +1838,8 @@ <h3 id="voice-props-voice-range">The 'voice-range' property</h3>
           <td>
             <em>Computed value:</em>
           </td>
-          <td>an absolute frequency or keyword value, and potentially, a frequency, semitone, or
-            percentage representing any non-zero offsets </td>
+          <td>an absolute frequency, or a keyword value and potentially also a frequency, semitone,
+            and/or percentage representing any non-zero offsets </td>
         </tr>
       </tbody>
     </table>
@@ -1852,24 +1853,26 @@ <h3 id="voice-props-voice-range">The 'voice-range' property</h3>
     <p class="note"> Note that the functionality provided by this property is related to the <a
         href="http://www.w3.org/TR/speech-synthesis11/#edef_prosody"><code>range</code> attribute of
         the <code>prosody</code> element</a> from the SSML markup language [[!SSML]]. </p>
+
     <dl>
       <dt>
         <strong>&lt;frequency&gt;</strong>
       </dt>
       <dd>
         <p> A value in <a href="#frequency-def">frequency</a> units (Hertz or kiloHertz, e.g.
           "100Hz", "+2kHz"). Values are restricted to positive numbers when the 'absolute' keyword
-          is used. Otherwise (when the 'absolute' keyword is not used), a negative value represents
-          an decrement, and a positive value represents an increment (relative to the inherited
-          value). For example, "2kHz" is a positive offset (strictly equivalent to "+2kHz"), and
-          "+2kHz absolute" is an absolute frequency (strictly equivalent to "2kHz absolute"). </p>
+          is specified. Otherwise (when the 'absolute' keyword is not specified), a negative value
+          represents a decrement, and a positive value represents an increment, relative to the
+          inherited value. For example, "2kHz" is a positive offset (strictly equivalent to
+          "+2kHz"), and "+2kHz absolute" is an absolute frequency (strictly equivalent to "2kHz
+          absolute"). </p>
       </dd>
       <dt>
         <strong>absolute</strong>
       </dt>
       <dd>
         <p> If specified, this keyword indicates that the specified frequency represents an absolute
-          value. If a negative frequency is specified, the computed frequency will be zero.</p>
+          value. If a negative frequency is specified, the computed frequency will be zero. </p>
       </dd>
       <dt>
         <strong>&lt;semitones&gt;</strong>
@@ -1880,7 +1883,7 @@ <h3 id="voice-props-voice-range">The 'voice-range' property</h3>
           "st" (semitones). A semitone is half of a tone (a half step) on the standard diatonic
           scale. As such, a semitone doesn't correspond to a fixed frequency: the ratio between two
           consecutive frequencies separated by exactly one semitone is the twelfth root of two
-          (approximately 1.05946). </p>
+          (approximately 1.05946).</p>
       </dd>
       <dt>
         <strong>&lt;percentage&gt;</strong>
@@ -1889,16 +1892,15 @@ <h3 id="voice-props-voice-range">The 'voice-range' property</h3>
         <p> Positive and negative <a href="#percentage-def">percentage</a> values are allowed, to
           represent an increment or decrement (respectively) relative to the inherited value.
           Computed values are calculated by adding (or subtracting) the specified fraction of the
-          inherited value, to (from) the inherited frequency value. For example, 50% (which is
-          equivalent to +50%) with a inherited value of 200Hz results in <code>200 +
-            (200*0.5)</code> = 300Hz. Conversely, -50% results in <code>200-(200*0.5)</code> =
-          100Hz. </p>
+          inherited value, to (from) the inherited value. For example, 50% (which is equivalent to
+          +50%) with a inherited value of 200Hz results in <code>200 + (200*0.5)</code> = 300Hz.
+          Conversely, -50% results in <code>200-(200*0.5)</code> = 100Hz. </p>
       </dd>
       <dt><strong>x-low</strong>, <strong>low</strong>, <strong>medium</strong>,
-          <strong>high</strong> and <strong>x-high</strong></dt>
+          <strong>high</strong>, <strong>x-high</strong></dt>
       <dd>
-        <p>A sequence of monotonically non-decreasing pitch ranges that are implementation and
-          language-dependent.</p>
+        <p>A sequence of monotonically non-decreasing pitch levels that are implementation and voice
+          specific.</p>
       </dd>
     </dl>
 
@@ -1913,24 +1915,52 @@ <h3 id="voice-props-voice-range">The 'voice-range' property</h3>
       <p>Examples of inherited values:</p>
       <pre>
 &lt;body&gt;
-  &lt;parent&gt;
-    &lt;child&gt;
-      &lt;grandchild&gt;
-      ...
-      &lt;/grandchild&gt;
-    &lt;/child&gt;
-  &lt;/parent&gt;
-&lt;/body&gt; 
-        
-body { voice-range: inherit; } /* the initial value is 'medium' */
-parent { voice-range: 200Hz absolute; } /* override with an absolute frequency */
-child { voice-range: 2st; } /* the computed value is [200Hz + two semitones] */
-grandchild { voice-range: inherit;
-             voice-family: "another-voice"; } /* the computed value is the same as
-                              for "child", but the voice is different so the
-                              calculated (used) absolute frequency
-                              may be completely different,
+  &lt;e1&gt;
+    &lt;e2&gt;
+      &lt;e3&gt;
+        &lt;e4&gt;
+          &lt;e5&gt;
+          ...
+          &lt;/e5&gt;
+        &lt;/e4&gt;
+      &lt;/e3&gt;
+    &lt;/e2&gt;
+  &lt;/e1&gt;
+&lt;/body&gt;
+
+
+
+
+body { voice-range: inherit; } /* the initial value is 'medium'
+                               (the actual frequency value
+                               depends on the active voice) */
+
+e1 { voice-range: +25%; } /* the computed value is
+                          ['medium' + 0.25 times the frequency
+                          corresponding to 'medium'] */
+
+e2 { voice-range: inherit; /* this could be omitted,
+                           but we explicitly specify it for clarity purposes */
+                           
+     voice-family: "another-voice"; } /* the computed value is the same as
+                              for "e1", but here the voice is different,
+                              so once calculated, the used absolute frequency
+                              may be completely different
                               due to voice-dependent discrepancies */
+
+e3 { voice-range: 200Hz absolute; } /* override with an absolute frequency
+                                    which doesn't depend on the active voice */
+
+e4 { voice-range: 2st; } /* the computed value is an absolute frequency,
+                         which is the result of the
+                         calculation: 200Hz + two semitones */
+
+e5 { voice-range: inherit; /* this could be omitted,
+                           but we explicitly specify it for clarity purposes */
+                           
+     voice-family: "yet-another-voice"; } /* the computed value is the same as
+                              for "e4" (i.e. an absolute frequency value,
+                              independent from the active voice) */
       </pre>
     </div>
     <table class="propdef" summary="name: syntax">