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

csswg/css3-speech Overview.html,1.70,1.71 Overview.src.html,1.71,1.72

From: Daniel Weck via cvs-syncmail <cvsmail@w3.org>
Date: Wed, 13 Jul 2011 17:56:38 +0000
To: public-css-commits@w3.org
Message-Id: <E1Qh3fq-0004Ey-Rp@lionel-hutz.w3.org>
Update of /sources/public/csswg/css3-speech
In directory hutz:/tmp/cvs-serv16238

Modified Files:
	Overview.html Overview.src.html 
Log Message:
pitch frequency "relative" keyword now "absolute"


Index: Overview.html
===================================================================
RCS file: /sources/public/csswg/css3-speech/Overview.html,v
retrieving revision 1.70
retrieving revision 1.71
diff -u -d -r1.70 -r1.71
--- Overview.html	13 Jul 2011 17:26:28 -0000	1.70
+++ Overview.html	13 Jul 2011 17:56:36 -0000	1.71
@@ -783,29 +783,6 @@
     behavior of the &lsquo;<code class=property>center</code>&rsquo; value.
   </ul>
 
-  <p class=note> Note that sound systems may be configured by users in such a
-   way that it would interfere with the left-right audio distribution
-   specified by document authors. Typically, the various "surround" modes
-   available in modern sound systems (including systems based on basic stereo
-   speakers) tend to greatly alter the perceived spatial arrangement of audio
-   signals. The illusion of a three-dimensional sound stage is often achieved
-   using a combination of phase shifting, digital delay, volume control
-   (channel mixing), and other techniques. Some users may even configure
-   their system to "downgrade" any rendered sound to a single mono channel,
-   in which case the effect of the &lsquo;<a href="#voice-balance"><code
-   class=property>voice-balance</code></a>&rsquo; property would obviously
-   not be perceivable at all. The rendering fidelity of authored content is
-   therefore dependent on such user customizations, and the &lsquo;<a
-   href="#voice-balance"><code class=property>voice-balance</code></a>&rsquo;
-   property merely specifies the desired end-result.
-
-  <p class=note> Note that many speech synthesizers only generate mono sound,
-   and therefore do not intrinsically support the &lsquo;<a
-   href="#voice-balance"><code class=property>voice-balance</code></a>&rsquo;
-   property. The sound distribution along the left-right axis consequently
-   occurs at post-synthesis stage (when the speech-enabled user-agent mixes
-   the various audio sources authored within the document)
-
   <p> Future revisions of the CSS Speech module may include support for
    three-dimensional audio, which would effectively enable authors to specify
    "azimuth" and "elevation" values. In the future, content authored using
@@ -840,6 +817,29 @@
     class=css>-50</code>&rsquo; maps to -20 degrees.
   </ul>
 
+  <p class=note> Note that sound systems may be configured by users in such a
+   way that it would interfere with the left-right audio distribution
+   specified by document authors. Typically, the various "surround" modes
+   available in modern sound systems (including systems based on basic stereo
+   speakers) tend to greatly alter the perceived spatial arrangement of audio
+   signals. The illusion of a three-dimensional sound stage is often achieved
+   using a combination of phase shifting, digital delay, volume control
+   (channel mixing), and other techniques. Some users may even configure
+   their system to "downgrade" any rendered sound to a single mono channel,
+   in which case the effect of the &lsquo;<a href="#voice-balance"><code
+   class=property>voice-balance</code></a>&rsquo; property would obviously
+   not be perceivable at all. The rendering fidelity of authored content is
+   therefore dependent on such user customizations, and the &lsquo;<a
+   href="#voice-balance"><code class=property>voice-balance</code></a>&rsquo;
+   property merely specifies the desired end-result.
+
+  <p class=note> Note that many speech synthesizers only generate mono sound,
+   and therefore do not intrinsically support the &lsquo;<a
+   href="#voice-balance"><code class=property>voice-balance</code></a>&rsquo;
+   property. The sound distribution along the left-right axis consequently
+   occurs at post-synthesis stage (when the speech-enabled user-agent mixes
+   the various audio sources authored within the document)
+
   <h2 id=speaking-props><span class=secno>6. </span>Speaking properties</h2>
 
   <h3 id=speaking-props-speak><span class=secno>6.1. </span>The &lsquo;<a
@@ -2119,7 +2119,7 @@
     <tr>
      <td> <em>Value:</em>
 
-     <td>&lt;frequency&gt; &amp;&amp; relative? | &lt;semitones&gt; |
+     <td>&lt;frequency&gt; &amp;&amp; absolute? | &lt;semitones&gt; |
       &lt;percentage&gt; | x-low | low | medium | high | x-high
 
     <tr>
@@ -2174,18 +2174,20 @@
    <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, unless the &lsquo;<code class=property>relative</code>&rsquo;
-     keyword is used. Computed frequency values that are negative numbers
-     result in the property being ignored.</p>
+     numbers when the &lsquo;<code class=property>absolute</code>&rsquo;
+     keyword is used. Otherwise, a negative value represents an decrement,
+     and a positive value represents an increment (relative to the inherited
+     frequency value). For example, "2kHz" is a positive offset (strictly
+     equivalent to "+2kHz"), unlike "+2kHz absolute" which is an absolute
+     frequency value (strictly equivalent to "2kHz absolute"). Computed
+     frequency values that are negative numbers result in the property being
+     ignored.</p>
 
-   <dt> <strong>relative</strong>
+   <dt> <strong>absolute</strong>
 
    <dd>
     <p> This keyword specifies that the provided frequency value is expressed
-     relatively to the inherited value, using a positive or negative offset.
-     For example, "2kHz relative" is an increment (strictly equivalent to
-     "+2kHz relative"), unlike "+2kHz" which is an absolute value (strictly
-     equivalent to "2kHz").</p>
+     as a positive absolute value.</p>
 
    <dt> <strong>&lt;semitones&gt;</strong>
 
@@ -2223,13 +2225,13 @@
    <p>Examples of property values:</p>
 
    <pre>
-h1 { voice-pitch: 250Hz; }
+h1 { voice-pitch: 250Hz; } /* positive offset relative to the inherited absolute frequency */
 h1 { voice-pitch: +250Hz; } /* identical to the line above */
-h2 { voice-pitch: +30Hz relative; }
-h2 { voice-pitch: 30Hz relative; } /* identical to the line above */
-h3 { voice-pitch: relative -20Hz; } /* the swapped keyword placement is a legal syntax */
-h4 { voice-pitch: -20Hz; } /* Illegal syntax ! ("relative" keyword is missing for negative frequency) */
-h4 { voice-pitch: -3.5st; } /* Legal syntax: semitones are always relative, no need for the keyword. */
+h2 { voice-pitch: +30Hz absolute; } /* not an increment! */
+h2 { voice-pitch: absolute 30Hz; } /* identical to the line above */
+h3 { voice-pitch: -20Hz; } /* negative offset (decrement) relative to the inherited absolute frequency */
+h4 { voice-pitch: -20Hz absolute; } /* Illegal syntax ! ("absolute" keyword not allowed with negative frequency) */
+h4 { voice-pitch: -3.5st; } /* Semitones are always relative, no need for the keyword. */
       </pre>
   </div>
 
@@ -2247,7 +2249,7 @@
     <tr>
      <td> <em>Value:</em>
 
-     <td>&lt;frequency&gt; &amp;&amp; relative? | &lt;semitones&gt; |
+     <td>&lt;frequency&gt; &amp;&amp; absolute? | &lt;semitones&gt; |
       &lt;percentage&gt; | x-low | low | medium | high | x-high
 
     <tr>
@@ -2302,18 +2304,20 @@
    <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, unless the &lsquo;<code class=property>relative</code>&rsquo;
-     keyword is used. Computed frequency values that are negative numbers
-     result in the property being ignored.</p>
+     numbers when the &lsquo;<code class=property>absolute</code>&rsquo;
+     keyword is used. Otherwise, a negative value represents an decrement,
+     and a positive value represents an increment (relative to the inherited
+     frequency value). For example, "2kHz" is a positive offset (strictly
+     equivalent to "+2kHz"), unlike "+2kHz absolute" which is an absolute
+     frequency value (strictly equivalent to "2kHz absolute"). Computed
+     frequency values that are negative numbers result in the property being
+     ignored.</p>
 
-   <dt> <strong>relative</strong>
+   <dt> <strong>absolute</strong>
 
    <dd>
     <p> This keyword specifies that the provided frequency value is expressed
-     relatively to the inherited value, using a positive or negative offset.
-     For example, "2kHz relative" is an increment (strictly equivalent to
-     "+2kHz relative"), unlike "+2kHz" which is an absolute value (strictly
-     equivalent to "2kHz").</p>
+     as a positive absolute value.</p>
 
    <dt> <strong>&lt;semitones&gt;</strong>
 
@@ -2972,7 +2976,7 @@
     <tr>
      <td><a class=property href="#voice-pitch">voice-pitch</a>
 
-     <td>&lt;frequency&gt; &amp;&amp; relative? | &lt;semitones&gt; |
+     <td>&lt;frequency&gt; &amp;&amp; absolute? | &lt;semitones&gt; |
       &lt;percentage&gt; | x-low | low | medium | high | x-high
 
      <td>medium
@@ -2988,7 +2992,7 @@
     <tr>
      <td><a class=property href="#voice-pitch-range">voice-pitch-range</a>
 
-     <td>&lt;frequency&gt; &amp;&amp; relative? | &lt;semitones&gt; |
+     <td>&lt;frequency&gt; &amp;&amp; absolute? | &lt;semitones&gt; |
       &lt;percentage&gt; | x-low | low | medium | high | x-high
 
      <td>medium
@@ -3535,8 +3539,7 @@
     class=property>voice-family</code></a>&rsquo; selection algorithm to
     cater for language changes.
 
-   <li>Separated definition of semitones, as they are relative values already
-    (unlike Hz frequencies).
+   <li>Separated definition of semitones (pitch properties).
 
    <li>More consistent behavior when audio cue URI fails (for whatever
     reason).
@@ -3564,7 +3567,7 @@
     value for &lsquo;<a href="#voice-stress"><code
     class=property>voice-stress</code></a>&rsquo;.
 
-   <li>Separated the &lsquo;<code class=property>relative</code>&rsquo;
+   <li>Separated the &lsquo;<code class=property>absolute</code>&rsquo;
     keyword for &lsquo;<a href="#voice-pitch"><code
     class=property>voice-pitch</code></a>&rsquo; and &lsquo;<code
     class=property>voice-range</code>&rsquo;.

Index: Overview.src.html
===================================================================
RCS file: /sources/public/csswg/css3-speech/Overview.src.html,v
retrieving revision 1.71
retrieving revision 1.72
diff -u -d -r1.71 -r1.72
--- Overview.src.html	13 Jul 2011 17:26:29 -0000	1.71
+++ Overview.src.html	13 Jul 2011 17:56:36 -0000	1.72
@@ -482,22 +482,6 @@
         used altogether in order to emulate the behavior of the 'center' value. </li>
     </ul>
 
-    <p class="note"> Note that sound systems may be configured by users in such a way that it would
-      interfere with the left-right audio distribution specified by document authors. Typically, the
-      various "surround" modes available in modern sound systems (including systems based on basic
-      stereo speakers) tend to greatly alter the perceived spatial arrangement of audio signals. The
-      illusion of a three-dimensional sound stage is often achieved using a combination of phase
-      shifting, digital delay, volume control (channel mixing), and other techniques. Some users may
-      even configure their system to "downgrade" any rendered sound to a single mono channel, in
-      which case the effect of the 'voice-balance' property would obviously not be perceivable at
-      all. The rendering fidelity of authored content is therefore dependent on such user
-      customizations, and the 'voice-balance' property merely specifies the desired end-result. </p>
-
-    <p class="note"> Note that many speech synthesizers only generate mono sound, and therefore do
-      not intrinsically support the 'voice-balance' property. The sound distribution along the
-      left-right axis consequently occurs at post-synthesis stage (when the speech-enabled
-      user-agent mixes the various audio sources authored within the document) </p>
-
     <p> Future revisions of the CSS Speech module may include support for three-dimensional audio,
       which would effectively enable authors to specify "azimuth" and "elevation" values. In the
       future, content authored using the current specification may therefore be consumed by
@@ -518,6 +502,22 @@
         degrees.</li>
     </ul>
 
+    <p class="note"> Note that sound systems may be configured by users in such a way that it would
+      interfere with the left-right audio distribution specified by document authors. Typically, the
+      various "surround" modes available in modern sound systems (including systems based on basic
+      stereo speakers) tend to greatly alter the perceived spatial arrangement of audio signals. The
+      illusion of a three-dimensional sound stage is often achieved using a combination of phase
+      shifting, digital delay, volume control (channel mixing), and other techniques. Some users may
+      even configure their system to "downgrade" any rendered sound to a single mono channel, in
+      which case the effect of the 'voice-balance' property would obviously not be perceivable at
+      all. The rendering fidelity of authored content is therefore dependent on such user
+      customizations, and the 'voice-balance' property merely specifies the desired end-result. </p>
+
+    <p class="note"> Note that many speech synthesizers only generate mono sound, and therefore do
+      not intrinsically support the 'voice-balance' property. The sound distribution along the
+      left-right axis consequently occurs at post-synthesis stage (when the speech-enabled
+      user-agent mixes the various audio sources authored within the document) </p>
+
     <h2 id="speaking-props">Speaking properties</h2>
     <h3 id="speaking-props-speak">The 'speak' property</h3>
     <table class="propdef" summary="name: syntax">
@@ -1666,7 +1666,7 @@
           <td>
             <em>Value:</em>
           </td>
-          <td>&lt;frequency&gt; &amp;&amp; relative? | &lt;semitones&gt; | &lt;percentage&gt; |
+          <td>&lt;frequency&gt; &amp;&amp; absolute? | &lt;semitones&gt; | &lt;percentage&gt; |
             x-low | low | medium | high | x-high </td>
         </tr>
         <tr>
@@ -1721,18 +1721,19 @@
       </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, unless the 'relative'
-          keyword is used. Computed frequency values that are negative numbers result in the
-          property being ignored. </p>
+          "100Hz", "+2kHz"). Values are restricted to positive numbers when the 'absolute' keyword
+          is used. Otherwise, a negative value represents an decrement, and a positive value
+          represents an increment (relative to the inherited frequency value). For example, "2kHz"
+          is a positive offset (strictly equivalent to "+2kHz"), unlike "+2kHz absolute" which is an
+          absolute frequency value (strictly equivalent to "2kHz absolute"). Computed frequency
+          values that are negative numbers result in the property being ignored. </p>
       </dd>
       <dt>
-        <strong>relative</strong>
+        <strong>absolute</strong>
       </dt>
       <dd>
-        <p> This keyword specifies that the provided frequency value is expressed relatively to the
-          inherited value, using a positive or negative offset. For example, "2kHz relative" is an
-          increment (strictly equivalent to "+2kHz relative"), unlike "+2kHz" which is an absolute
-          value (strictly equivalent to "2kHz"). </p>
+        <p> This keyword specifies that the provided frequency value is expressed as a positive
+          absolute value.</p>
       </dd>
       <dt>
         <strong>&lt;semitones&gt;</strong>
@@ -1767,13 +1768,13 @@
     <div class="example">
       <p>Examples of property values:</p>
       <pre>
-h1 { voice-pitch: 250Hz; }
+h1 { voice-pitch: 250Hz; } /* positive offset relative to the inherited absolute frequency */
 h1 { voice-pitch: +250Hz; } /* identical to the line above */
-h2 { voice-pitch: +30Hz relative; }
-h2 { voice-pitch: 30Hz relative; } /* identical to the line above */
-h3 { voice-pitch: relative -20Hz; } /* the swapped keyword placement is a legal syntax */
-h4 { voice-pitch: -20Hz; } /* Illegal syntax ! ("relative" keyword is missing for negative frequency) */
-h4 { voice-pitch: -3.5st; } /* Legal syntax: semitones are always relative, no need for the keyword. */
+h2 { voice-pitch: +30Hz absolute; } /* not an increment! */
+h2 { voice-pitch: absolute 30Hz; } /* identical to the line above */
+h3 { voice-pitch: -20Hz; } /* negative offset (decrement) relative to the inherited absolute frequency */
+h4 { voice-pitch: -20Hz absolute; } /* Illegal syntax ! ("absolute" keyword not allowed with negative frequency) */
+h4 { voice-pitch: -3.5st; } /* Semitones are always relative, no need for the keyword. */
       </pre>
     </div>
     <h3 id="voice-props-voice-pitch-range">The 'voice-pitch-range' property</h3>
@@ -1789,7 +1790,7 @@
           <td>
             <em>Value:</em>
           </td>
-          <td>&lt;frequency&gt; &amp;&amp; relative? | &lt;semitones&gt; | &lt;percentage&gt; |
+          <td>&lt;frequency&gt; &amp;&amp; absolute? | &lt;semitones&gt; | &lt;percentage&gt; |
             x-low | low | medium | high | x-high </td>
         </tr>
         <tr>
@@ -1845,18 +1846,19 @@
       </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, unless the 'relative'
-          keyword is used. Computed frequency values that are negative numbers result in the
-          property being ignored. </p>
+          "100Hz", "+2kHz"). Values are restricted to positive numbers when the 'absolute' keyword
+          is used. Otherwise, a negative value represents an decrement, and a positive value
+          represents an increment (relative to the inherited frequency value). For example, "2kHz"
+          is a positive offset (strictly equivalent to "+2kHz"), unlike "+2kHz absolute" which is an
+          absolute frequency value (strictly equivalent to "2kHz absolute"). Computed frequency
+          values that are negative numbers result in the property being ignored. </p>
       </dd>
       <dt>
-        <strong>relative</strong>
+        <strong>absolute</strong>
       </dt>
       <dd>
-        <p> This keyword specifies that the provided frequency value is expressed relatively to the
-          inherited value, using a positive or negative offset. For example, "2kHz relative" is an
-          increment (strictly equivalent to "+2kHz relative"), unlike "+2kHz" which is an absolute
-          value (strictly equivalent to "2kHz"). </p>
+        <p> This keyword specifies that the provided frequency value is expressed as a positive
+          absolute value.</p>
       </dd>
       <dt>
         <strong>&lt;semitones&gt;</strong>
@@ -2478,8 +2480,7 @@
       <li>Added the 'normal' value for voice-rate ("default" in SSML 1.1).</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, as they are relative values already (unlike Hz
-        frequencies).</li>
+      <li>Separated definition of semitones (pitch properties).</li>
       <li>More consistent behavior when audio cue URI fails (for whatever reason).</li>
       <li>Enabled voice-family names to contain spaces, matching 'font-family' syntax which is based
         on quoted strings and concatenated identifiers.</li>
@@ -2491,7 +2492,7 @@
         'young' and 'old'). This aligns with SSML. </li>
       <li>Improved the pause collapsing prose, removed redundant paragraphs.</li>
       <li>Added the missing 'normal' value for 'voice-stress'.</li>
-      <li>Separated the 'relative' keyword for 'voice-pitch' and 'voice-range'.</li>
+      <li>Separated the 'absolute' keyword for 'voice-pitch' and 'voice-range'.</li>
       <li>Improved document structure by adding sub-sections.</li>
       <li>Removed the implicit 'inherit' value for all properties.</li>
       <li>Fixed typos and made other minor edits.</li>
Received on Wednesday, 13 July 2011 17:56:40 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Wednesday, 13 July 2011 17:56:40 GMT