- From: Daniel Weck via cvs-syncmail <cvsmail@w3.org>
- Date: Wed, 13 Jul 2011 20:03:43 +0000
- To: public-css-commits@w3.org
Update of /sources/public/csswg/css3-speech
In directory hutz:/tmp/cvs-serv4810
Modified Files:
Overview.html Overview.src.html
Log Message:
renamed voice-pitch-range to voice-range
fixed clamping for out-of-range (actual user agent) values
Index: Overview.html
===================================================================
RCS file: /sources/public/csswg/css3-speech/Overview.html,v
retrieving revision 1.73
retrieving revision 1.74
diff -u -d -r1.73 -r1.74
--- Overview.html 13 Jul 2011 18:11:45 -0000 1.73
+++ Overview.html 13 Jul 2011 20:03:41 -0000 1.74
@@ -308,8 +308,8 @@
</span>The ‘<code class=property>voice-pitch</code>’
property</a>
- <li><a href="#voice-props-voice-pitch-range"><span class=secno>10.4.
- </span>The ‘<code class=property>voice-pitch-range</code>’
+ <li><a href="#voice-props-voice-range"><span class=secno>10.4.
+ </span>The ‘<code class=property>voice-range</code>’
property</a>
</ul>
@@ -2162,6 +2162,13 @@
pitch of the output). For example, the common pitch for a male voice is
around 120Hz, whereas it is around 210Hz for a female voice.
+ <p> Speech-capable user agents are likely to support a specific range of
+ values rather than the full range of possible computed numerical values
+ for frequencies. The actual values in user agents may therefore be clamped
+ to implementation-dependent minimum and maximum boundaries. For example:
+ although the 0Hz frequency can be legitimately computed, it may be clamped
+ to a more meaningful value in the context of the speech synthesizer.
+
<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>pitch</code>
@@ -2175,43 +2182,47 @@
<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 ‘<code class=property>absolute</code>’
- 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>
+ keyword is used. Otherwise (when the ‘<code
+ class=property>absolute</code>’ 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").
+ Computed absolute frequency values that are negative are clamped to zero
+ Hertz.</p>
<dt> <strong>absolute</strong>
<dd>
- <p> This keyword specifies that the provided frequency value is expressed
- as a positive absolute value.</p>
+ <p> This keyword specifies that the provided frequency is expressed as an
+ absolute, positive value. When a negative value is provided, it is
+ clamped to zero.</p>
<dt> <strong><semitones></strong>
<dd>
<p> Specifies a relative change (decrement or increment) to the inherited
- frequency value. The syntax of allowed values is a <<a
+ value. The syntax of allowed values is a <<a
href="#number-def">number</a>> 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>
+ Computed absolute frequency values that are negative are clamped to zero
+ Hertz.</p>
<dt> <strong><percentage></strong>
<dd>
<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>
+ relative to the inherited value. Computed values are calculated by
+ adding (or subtracting) the specified fraction of the 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. Computed absolute frequency values
+ that are negative are clamped to zero Hertz.</p>
<dt><strong>x-low</strong>, <strong>low</strong>, <strong>medium</strong>,
<strong>high</strong>, <strong>x-high</strong>
@@ -2237,16 +2248,16 @@
</pre>
</div>
- <h3 id=voice-props-voice-pitch-range><span class=secno>10.4. </span>The
- ‘<a href="#voice-pitch-range"><code
- class=property>voice-pitch-range</code></a>’ property</h3>
+ <h3 id=voice-props-voice-range><span class=secno>10.4. </span>The ‘<a
+ href="#voice-range"><code class=property>voice-range</code></a>’
+ property</h3>
<table class=propdef summary="name: syntax">
<tbody>
<tr>
<td>Name:
- <td> <dfn id=voice-pitch-range>voice-pitch-range</dfn>
+ <td> <dfn id=voice-range>voice-range</dfn>
<tr>
<td> <em>Value:</em>
@@ -2285,8 +2296,8 @@
<td>specified value
</table>
- <p> The ‘<a href="#voice-pitch-range"><code
- class=property>voice-pitch-range</code></a>’ property specifies the
+ <p> The ‘<a href="#voice-range"><code
+ class=property>voice-range</code></a>’ property specifies the
variability in the "baseline" pitch, i.e. how much the fundamental
frequency may deviate from the average pitch of the speech output. The
dynamic pitch range of the generated speech generally increases for a
@@ -2294,6 +2305,13 @@
to convey meaning and emphasis in speech. Typically, a low range produces
a flat, monotonic voice, whereas a high range produces an animated voice.
+ <p> Speech-capable user agents are likely to support a specific range of
+ values rather than the full range of possible computed numerical values
+ for frequencies. The actual values in user agents may therefore be clamped
+ to implementation-dependent minimum and maximum boundaries. For example:
+ although the 0Hz frequency can be legitimately computed, it may be clamped
+ to a more meaningful value in the context of the speech synthesizer.
+
<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>
@@ -2307,42 +2325,47 @@
<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 ‘<code class=property>absolute</code>’
- 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>
+ keyword is used. Otherwise (when the ‘<code
+ class=property>absolute</code>’ 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").
+ Computed absolute frequency values that are negative are clamped to zero
+ Hertz.</p>
<dt> <strong>absolute</strong>
<dd>
- <p> This keyword specifies that the provided frequency value is expressed
- as a positive absolute value.</p>
+ <p> This keyword specifies that the provided frequency is expressed as an
+ absolute, positive value. When a negative value is provided, it is
+ clamped to zero.</p>
<dt> <strong><semitones></strong>
<dd>
<p> Specifies a relative change (decrement or increment) to the inherited
- frequency value. The syntax of allowed values is a <<a
+ value. The syntax of allowed values is a <<a
href="#number-def">number</a>> 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>
+ exactly one semitone is the twelfth root of two (approximately 1.05946).
+ Computed absolute frequency values that are negative are clamped to zero
+ Hertz.</p>
<dt> <strong><percentage></strong>
<dd>
<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>
+ 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. Computed absolute frequency values
+ that are negative are clamped to zero Hertz.</p>
<dt><strong>x-low</strong>, <strong>low</strong>, <strong>medium</strong>,
<strong>high</strong> and <strong>x-high</strong>
@@ -2992,7 +3015,7 @@
<td>speech
<tr>
- <td><a class=property href="#voice-pitch-range">voice-pitch-range</a>
+ <td><a class=property href="#voice-range">voice-range</a>
<td><frequency> && absolute? | <semitones> |
<percentage> | x-low | low | medium | high | x-high
@@ -3263,8 +3286,8 @@
<li>voice-pitch, <a href="#voice-pitch"
title=voice-pitch><strong>10.3.</strong></a>
- <li>voice-pitch-range, <a href="#voice-pitch-range"
- title=voice-pitch-range><strong>10.4.</strong></a>
+ <li>voice-range, <a href="#voice-range"
+ title=voice-range><strong>10.4.</strong></a>
<li>voice-rate, <a href="#voice-rate"
title=voice-rate><strong>10.2.</strong></a>
@@ -3481,6 +3504,13 @@
list of changes</a>, which - for succinctness - is not repeated here.
<ul>
+ <li>Renamed ‘<code class=property>voice-pitch-range</code>’ to
+ ‘<a href="#voice-range"><code
+ class=property>voice-range</code></a>’, which is compatible with
+ SSML's notation, and removes the possibility to interpret this property
+ as being a subset of ‘<a href="#voice-pitch"><code
+ class=property>voice-pitch</code></a>’.
+
<li>Removed the "phonemes" property (and its associated "@alphabet"
at-rule).
@@ -3507,9 +3537,8 @@
class=property>rest</code></a>’, which should be zero (were
"implementation-dependent").
- <li>Corrected the [initial] values for ‘<a
- href="#voice-pitch-range"><code
- class=property>voice-pitch-range</code></a>’ and ‘<a
+ <li>Corrected the [initial] values for ‘<a href="#voice-range"><code
+ class=property>voice-range</code></a>’ and ‘<a
href="#voice-pitch"><code class=property>voice-pitch</code></a>’ to
"medium".
@@ -3571,8 +3600,8 @@
<li>Separated the ‘<code class=property>absolute</code>’
keyword for ‘<a href="#voice-pitch"><code
- class=property>voice-pitch</code></a>’ and ‘<code
- class=property>voice-range</code>’.
+ class=property>voice-pitch</code></a>’ and ‘<a
+ href="#voice-range"><code class=property>voice-range</code></a>’.
<li>Improved document structure by adding sub-sections.
Index: Overview.src.html
===================================================================
RCS file: /sources/public/csswg/css3-speech/Overview.src.html,v
retrieving revision 1.74
retrieving revision 1.75
diff -u -d -r1.74 -r1.75
--- Overview.src.html 13 Jul 2011 18:11:45 -0000 1.74
+++ Overview.src.html 13 Jul 2011 20:03:41 -0000 1.75
@@ -1712,6 +1712,13 @@
processors (it approximately corresponds to the average pitch of the output). For example, the
common pitch for a male voice is around 120Hz, whereas it is around 210Hz for a female
voice.</p>
+
+ <p> Speech-capable user agents are likely to support a specific range of values rather than the
+ full range of possible computed numerical values for frequencies. The actual values in user
+ agents may therefore be clamped to implementation-dependent minimum and maximum boundaries.
+ For example: although the 0Hz frequency can be legitimately computed, it may be clamped to a
+ more meaningful value in the context of the speech synthesizer. </p>
+
<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>pitch</code> attribute of
the <code>prosody</code> element</a> from the SSML markup language [[!SSML]]. </p>
@@ -1722,41 +1729,42 @@
<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, 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>
+ 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").
+ Computed absolute frequency values that are negative are clamped to zero Hertz. </p>
</dd>
<dt>
<strong>absolute</strong>
</dt>
<dd>
- <p> This keyword specifies that the provided frequency value is expressed as a positive
- absolute value.</p>
+ <p> This keyword specifies that the provided frequency is expressed as an absolute, positive
+ value. When a negative value is provided, it is clamped to zero. </p>
</dd>
<dt>
<strong><semitones></strong>
</dt>
<dd>
- <p> Specifies a relative change (decrement or increment) to the inherited frequency value.
- The syntax of allowed values is a <<a href="#number-def">number</a>> 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 value. The syntax
+ of allowed values is a <<a href="#number-def">number</a>> 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). Computed absolute frequency values that are negative are clamped
+ to zero Hertz. </p>
</dd>
<dt>
<strong><percentage></strong>
</dt>
<dd>
<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>
+ 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 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. Computed absolute
+ frequency values that are negative are clamped to zero Hertz. </p>
</dd>
<dt><strong>x-low</strong>, <strong>low</strong>, <strong>medium</strong>,
<strong>high</strong>, <strong>x-high</strong></dt>
@@ -1779,13 +1787,13 @@
h6 { voice-pitch: +25%; } /* identical to the line above */
</pre>
</div>
- <h3 id="voice-props-voice-pitch-range">The 'voice-pitch-range' property</h3>
+ <h3 id="voice-props-voice-range">The 'voice-range' property</h3>
<table class="propdef" summary="name: syntax">
<tbody>
<tr>
<td>Name:</td>
<td>
- <dfn id="voice-pitch-range">voice-pitch-range</dfn>
+ <dfn id="voice-range">voice-range</dfn>
</td>
</tr>
<tr>
@@ -1833,12 +1841,18 @@
</tr>
</tbody>
</table>
- <p> The 'voice-pitch-range' property specifies the variability in the "baseline" pitch, i.e. how
- much the fundamental frequency may deviate from the average pitch of the speech output. The
- dynamic pitch range of the generated speech generally increases for a highly animated voice,
- for example when variations in inflection are used to convey meaning and emphasis in speech.
+ <p> The 'voice-range' property specifies the variability in the "baseline" pitch, i.e. how much
+ the fundamental frequency may deviate from the average pitch of the speech output. The dynamic
+ pitch range of the generated speech generally increases for a highly animated voice, for
+ example when variations in inflection are used to convey meaning and emphasis in speech.
Typically, a low range produces a flat, monotonic voice, whereas a high range produces an
animated voice. </p>
+ <p> Speech-capable user agents are likely to support a specific range of values rather than the
+ full range of possible computed numerical values for frequencies. The actual values in user
+ agents may therefore be clamped to implementation-dependent minimum and maximum boundaries.
+ For example: although the 0Hz frequency can be legitimately computed, it may be clamped to a
+ more meaningful value in the context of the speech synthesizer. </p>
+
<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>
@@ -1849,41 +1863,43 @@
<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, 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>
+ 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").
+ Computed absolute frequency values that are negative are clamped to zero Hertz. </p>
</dd>
<dt>
<strong>absolute</strong>
</dt>
<dd>
- <p> This keyword specifies that the provided frequency value is expressed as a positive
- absolute value.</p>
+ <p> This keyword specifies that the provided frequency is expressed as an absolute, positive
+ value. When a negative value is provided, it is clamped to zero. </p>
</dd>
<dt>
<strong><semitones></strong>
</dt>
<dd>
- <p> Specifies a relative change (decrement or increment) to the inherited frequency value.
- The syntax of allowed values is a <<a href="#number-def">number</a>> 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 value. The syntax
+ of allowed values is a <<a href="#number-def">number</a>> 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). Computed absolute frequency values that are negative are clamped
+ to zero Hertz. </p>
</dd>
<dt>
<strong><percentage></strong>
</dt>
<dd>
<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 +
+ 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>
+ 100Hz. Computed absolute frequency values that are negative are clamped to zero Hertz.
+ </p>
</dd>
<dt><strong>x-low</strong>, <strong>low</strong>, <strong>medium</strong>,
<strong>high</strong> and <strong>x-high</strong></dt>
@@ -2459,6 +2475,9 @@
Draft</a> includes <a href="http://www.w3.org/TR/2011/WD-css3-speech-20110419#changes">its
own list of changes</a>, which - for succinctness - is not repeated here. </p>
<ul>
+ <li>Renamed 'voice-pitch-range' to 'voice-range', which is compatible with SSML's notation,
+ and removes the possibility to interpret this property as being a subset of
+ 'voice-pitch'.</li>
<li>Removed the "phonemes" property (and its associated "@alphabet" at-rule).</li>
<li>Renamed 'speakability' to 'speak', and 'speak' to 'speak-as'. Reorganized the 'speak-as'
values to allow mixing different types.</li>
@@ -2469,7 +2488,7 @@
<li>Fixed 'voice-volume' by conforming to SSML 1.1 (dB scale, etc.).</li>
<li>Fixed the [initial] values for 'pause' and 'rest', which should be zero (were
"implementation-dependent").</li>
- <li>Corrected the [initial] values for 'voice-pitch-range' and 'voice-pitch' to "medium".</li>
+ <li>Corrected the [initial] values for 'voice-range' and 'voice-pitch' to "medium".</li>
<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>
Received on Wednesday, 13 July 2011 20:03:45 UTC