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

csswg/css3-speech Overview.html,1.78,1.79 Overview.src.html,1.79,1.80

From: Daniel Weck via cvs-syncmail <cvsmail@w3.org>
Date: Wed, 13 Jul 2011 21:59:26 +0000
To: public-css-commits@w3.org
Message-Id: <E1Qh7So-00061s-7G@lionel-hutz.w3.org>
Update of /sources/public/csswg/css3-speech
In directory hutz:/tmp/cvs-serv23143

Modified Files:
	Overview.html Overview.src.html 
Log Message:
updated computed value definition, and inheritance example



Index: Overview.html
===================================================================
RCS file: /sources/public/csswg/css3-speech/Overview.html,v
retrieving revision 1.78
retrieving revision 1.79
diff -u -d -r1.78 -r1.79
--- Overview.html	13 Jul 2011 21:24:49 -0000	1.78
+++ Overview.html	13 Jul 2011 21:59:24 -0000	1.79
@@ -2150,8 +2150,9 @@
     <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 @@
     <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 @@
     <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 @@
     <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 @@
      (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 @@
      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 @@
 
    <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>
 

Index: Overview.src.html
===================================================================
RCS file: /sources/public/csswg/css3-speech/Overview.src.html,v
retrieving revision 1.79
retrieving revision 1.80
diff -u -d -r1.79 -r1.80
--- Overview.src.html	13 Jul 2011 21:24:49 -0000	1.79
+++ Overview.src.html	13 Jul 2011 21:59:24 -0000	1.80
@@ -1703,8 +1703,8 @@
           <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 @@
       <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 @@
           <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,6 +1853,7 @@
     <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>
@@ -1859,17 +1861,18 @@
       <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 @@
           "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 @@
         <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 @@
       <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">
Received on Wednesday, 13 July 2011 21:59:27 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Wednesday, 13 July 2011 21:59:28 GMT