csswg/css3-speech Overview.html,1.68,1.69 Overview.src.html,1.69,1.70

Update of /sources/public/csswg/css3-speech
In directory hutz:/tmp/cvs-serv9814

Modified Files:
	Overview.html Overview.src.html 
Log Message:
reformulated pitch properties percentage values.


Index: Overview.html
===================================================================
RCS file: /sources/public/csswg/css3-speech/Overview.html,v
retrieving revision 1.68
retrieving revision 1.69
diff -u -d -r1.68 -r1.69
--- Overview.html	13 Jul 2011 15:59:47 -0000	1.68
+++ Overview.html	13 Jul 2011 17:16:59 -0000	1.69
@@ -2174,23 +2174,23 @@
    <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), and using negative numbers results in the property
-     value being ignored.</p>
+     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>
 
    <dt> <strong>relative</strong>
 
    <dd>
     <p> This keyword specifies that the provided frequency value is expressed
      relatively to the inherited value, with positive or negative numbers.
-     For example, "+2kHz relative" is an increment, unlike "+2kHz" which is a
-     positive absolute value.</p>
+     For example, "2kHz relative" is an increment, unlike "+2kHz" which is an
+     absolute value.</p>
 
    <dt> <strong>&lt;semitones&gt;</strong>
 
    <dd>
     <p> Specifies a relative change (decrement or increment) to the inherited
-     value. The syntax of allowed values is a &lt;<a
+     frequency value. The syntax of allowed values is a &lt;<a
      href="#number-def">number</a>&gt; followed immediately by "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
@@ -2201,10 +2201,14 @@
    <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 inherited value.
-     For example, 50% means that the inherited value gets multiplied by 0.5,
-     which results in half the inherited pitch of the voice.</p>
+    <p> Positive and negative <a href="#percentage-def">percentage</a> values
+     are allowed, to represent an increment or decrement (respectively)
+     relative to the inherited frequency value. Computed values are
+     calculated by adding (or subtracting) the specified fraction of the
+     inherited frequency 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>
 
    <dt><strong>x-low</strong>, <strong>low</strong>, <strong>medium</strong>,
     <strong>high</strong>, <strong>x-high</strong>
@@ -2297,9 +2301,9 @@
    <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), and using negative numbers results in the property
-     value being ignored.</p>
+     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>
 
    <dt> <strong>relative</strong>
 
@@ -2313,7 +2317,7 @@
 
    <dd>
     <p> Specifies a relative change (decrement or increment) to the inherited
-     value. The syntax of allowed values is a &lt;<a
+     frequency value. The syntax of allowed values is a &lt;<a
      href="#number-def">number</a>&gt; followed immediately by "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
@@ -2323,10 +2327,14 @@
    <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 inherited value.
-     For example, 50% means that the inherited value gets multiplied by 0.5,
-     which results in half the inherited pitch range of the voice.</p>
+    <p> Positive and negative <a href="#percentage-def">percentage</a> values
+     are allowed, to represent an increment or decrement (respectively)
+     relative to the inherited frequency value. Computed values are
+     calculated by adding (or subtracting) the specified fraction of the
+     inherited frequency 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>
 
    <dt><strong>x-low</strong>, <strong>low</strong>, <strong>medium</strong>,
     <strong>high</strong> and <strong>x-high</strong>
@@ -3505,6 +3513,17 @@
     class=property>voice-balance</code></a>&rsquo; values outside of the
     allowed range (clamping).
 
+   <li>Fixed &lsquo;<a href="#voice-balance"><code
+    class=property>voice-balance</code></a>&rsquo; prose to better explain
+    the relationship between author intent (stereo sound distribution) and
+    actual user sound system setup (mono, stereo, or surround speaker layout
+    / mixing capabilities).
+
+   <li>Added prose for &lsquo;<a href="#voice-balance"><code
+    class=property>voice-balance</code></a>&rsquo; to describe the mapping
+    between stereo left-right sound axis and three-dimensional sound stage
+    (azimuth support in future versions of CSS-Speech).
+
    <li>Added the &lsquo;<code class=property>normal</code>&rsquo; value for
     voice-rate ("default" in SSML 1.1).
 

Index: Overview.src.html
===================================================================
RCS file: /sources/public/csswg/css3-speech/Overview.src.html,v
retrieving revision 1.69
retrieving revision 1.70
diff -u -d -r1.69 -r1.70
--- Overview.src.html	13 Jul 2011 15:59:47 -0000	1.69
+++ Overview.src.html	13 Jul 2011 17:16:59 -0000	1.70
@@ -1721,37 +1721,40 @@
       </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), and using negative numbers results in the property value being ignored.
-        </p>
+          "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>
       </dd>
       <dt>
         <strong>relative</strong>
       </dt>
       <dd>
         <p> This keyword specifies that the provided frequency value is expressed relatively to the
-          inherited value, with positive or negative numbers. For example, "+2kHz relative" is an
-          increment, unlike "+2kHz" which is a positive absolute value. </p>
+          inherited value, with positive or negative numbers. For example, "2kHz relative" is an
+          increment, unlike "+2kHz" which is an absolute value. </p>
       </dd>
       <dt>
         <strong>&lt;semitones&gt;</strong>
       </dt>
       <dd>
-        <p> Specifies a relative change (decrement or increment) to the inherited value. The syntax
-          of allowed values is a &lt;<a href="#number-def">number</a>&gt; followed immediately by
-          "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>
+        <p> Specifies a relative change (decrement or increment) to the inherited frequency value.
+          The syntax of allowed values is a &lt;<a href="#number-def">number</a>&gt; followed
+          immediately by "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>
       </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 inherited value. For example, 50% means that the
-          inherited value gets multiplied by 0.5, which results in half the inherited pitch of the
-          voice. </p>
+        <p> Positive and negative <a href="#percentage-def">percentage</a> values are allowed, to
+          represent an increment or decrement (respectively) relative to the inherited frequency
+          value. Computed values are calculated by adding (or subtracting) the specified fraction of
+          the inherited frequency 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>
       </dd>
       <dt><strong>x-low</strong>, <strong>low</strong>, <strong>medium</strong>,
           <strong>high</strong>, <strong>x-high</strong></dt>
@@ -1841,9 +1844,9 @@
       </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), and using negative numbers results in the property value being ignored.
-        </p>
+          "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>
       </dd>
       <dt>
         <strong>relative</strong>
@@ -1857,21 +1860,24 @@
         <strong>&lt;semitones&gt;</strong>
       </dt>
       <dd>
-        <p> Specifies a relative change (decrement or increment) to the inherited value. The syntax
-          of allowed values is a &lt;<a href="#number-def">number</a>&gt; followed immediately by
-          "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>
+        <p> Specifies a relative change (decrement or increment) to the inherited frequency value.
+          The syntax of allowed values is a &lt;<a href="#number-def">number</a>&gt; followed
+          immediately by "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>
       </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 inherited value. For example, 50% means that the
-          inherited value gets multiplied by 0.5, which results in half the inherited pitch range of
-          the voice. </p>
+        <p> Positive and negative <a href="#percentage-def">percentage</a> values are allowed, to
+          represent an increment or decrement (respectively) relative to the inherited frequency
+          value. Computed values are calculated by adding (or subtracting) the specified fraction of
+          the inherited frequency 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>
       </dd>
       <dt><strong>x-low</strong>, <strong>low</strong>, <strong>medium</strong>,
           <strong>high</strong> and <strong>x-high</strong></dt>
@@ -2461,6 +2467,12 @@
       <li>Added an "auto" value to 'voice-duration', which is the [initial] property value as
         well.</li>
       <li>Handling of 'voice-balance' values outside of the allowed range (clamping).</li>
+      <li>Fixed 'voice-balance' prose to better explain the relationship between author intent
+        (stereo sound distribution) and actual user sound system setup (mono, stereo, or surround
+        speaker layout / mixing capabilities).</li>
+      <li>Added prose for 'voice-balance' to describe the mapping between stereo left-right sound
+        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>Renamed voice-family fields to be consistent with SSML.</li>
       <li>Improved the 'voice-family' selection algorithm to cater for language changes.</li>

Received on Wednesday, 13 July 2011 17:17:03 UTC