- From: Daniel Weck via cvs-syncmail <cvsmail@w3.org>
- Date: Wed, 11 May 2011 01:27:16 +0000
- To: public-css-commits@w3.org
Update of /sources/public/csswg/css3-speech
In directory hutz:/tmp/cvs-serv26143
Modified Files:
Overview.html Overview.src.html
Log Message:
added the "linear" keyword to voice-volume numerical scale
Index: Overview.html
===================================================================
RCS file: /sources/public/csswg/css3-speech/Overview.html,v
retrieving revision 1.47
retrieving revision 1.48
diff -u -d -r1.47 -r1.48
--- Overview.html 11 May 2011 00:44:39 -0000 1.47
+++ Overview.html 11 May 2011 01:27:14 -0000 1.48
@@ -529,13 +529,13 @@
<tr>
<td> <em>Value:</em>
- <td><non-negative number> | <percentage> | silent | x-soft |
- soft | medium | loud | x-loud | inherit
+ <td>[<non-negative number> linear?] | <percentage> | silent
+ | x-soft | soft | medium | loud | x-loud | inherit
<tr>
<td> <em>Initial:</em>
- <td>medium
+ <td>50
<tr>
<td> <em>Applies to:</em>
@@ -578,19 +578,23 @@
rel=biblioentry>[SPEECH-SYNTHESIS]<!--{{!SPEECH-SYNTHESIS}}--></a>.
<dl>
- <dt> <strong><non-negative number></strong>
+ <dt> <strong><non-negative number> (followed by the optional
+ "linear" keyword)</strong>
<dd>An integer or floating point <a
href="#non-negative-number-def">positive number</a> in the range
‘<code class=css>0</code>’ to ‘<code
- class=css>100</code>’. ‘<code class=css>0</code>’
- represents the <em>minimum audible</em> level, and ‘<code
- class=css>100</code>’ corresponds to the <em>maximum tolerable</em>
- level. ‘<code class=css>50</code>’ corresponds to the user's
- preferred volume level. The numerical values exposed here are mapped to
- concrete volume levels that depend on the listening context. This allows
- authors to write a single style sheet that'll work in a variety of
- situations.
+ class=css>100</code>’, followed by the optional space character and
+ "linear" keyword. The interpretation of the ‘<code
+ class=css>0</code>’ to ‘<code class=css>100</code>’
+ scale depends on whether the "linear" keyword is used. When not used:
+ ‘<code class=css>0</code>’ represents the <em>minimum
+ audible</em> level and ‘<code class=css>100</code>’
+ corresponds to the <em>maximum tolerable</em> level. ‘<code
+ class=css>50</code>’ corresponds to the user's <em>preferred</em>
+ volume level. As such, the numerical values are mapped to concrete volume
+ levels that depend on the listening context. This allows authors to write
+ a single style sheet that should work in a variety of situations.
<p class=note>Note that actual volume levels depend on various factors,
such as the listening environment and personal user preferences. The
effective volume variation between ‘<code
@@ -605,6 +609,11 @@
class=css>0</code>’ and ‘<code class=css>100</code>’
are set to low volume levels (for example when listening discretely at
night).</p>
+ When the "linear" keyword is specified, ‘<code
+ class=css>0</code>’ maps to ‘<code
+ class=property>silent</code>’ and ‘<code
+ class=css>100</code>’ maps to the maximum possible audio volume
+ output. The values in between are placed on a linear amplitude scale.
<dt> <strong><percentage></strong>
@@ -618,43 +627,35 @@
<dt> <strong>silent</strong>
- <dd>No sound output at all (note that this is not equivalent to the value
- ‘<code class=css>0</code>’).
+ <dd>No sound output.
<dt><strong>x-soft</strong>, <strong>soft</strong>,
<strong>medium</strong>, <strong>loud</strong>, and
<strong>x-loud</strong>
- <dd>The value of ‘<code class=property>x-soft</code>’ is
- mapped to ‘<code class=css>0</code>’ (<em>minimum
- audible</em>) and ‘<code class=property>x-loud</code>’ is
- mapped to ‘<code class=css>100</code>’ (<em>maximum
- tolerable</em>). The value ‘<code
- class=property>medium</code>’ corresponds to ‘<code
- class=css>50</code>’ (<em>preferred</em> volume level) and is the
- default. The intermediary values ‘<code
- class=property>soft</code>’ and ‘<code
- class=property>loud</code>’ are mapped to ‘<code
- class=css>25</code>’ and ‘<code class=css>75</code>’,
- respectively. Because the numerical volume scale may or may not be linear
- amplitude, this sequence of "named" values increases from ‘<code
+ <dd>The value ‘<code class=property>x-soft</code>’ maps to 0,
+ ‘<code class=property>soft</code>’ maps to 25, ‘<code
+ class=property>medium</code>’ maps to 50, ‘<code
+ class=property>loud</code>’ maps to 75 and ‘<code
+ class=property>x-loud</code>’ maps to 100. When the numerical
+ volume scale is linear, the sequence from ‘<code
class=property>x-soft</code>’ to ‘<code
- class=property>x-loud</code>’, but does not necessarily map to
- monotonically non-decreasing volume levels.
+ class=property>x-loud</code>’ corresponds to monotonically
+ non-decreasing volume levels.
</dl>
<p class=note> Note that there is a difference between an element whose
‘<a href="#voice-volume"><code
class=property>voice-volume</code></a>’ property has a value of
- ‘<code class=property>silent</code>’, and an element whose
- ‘<a href="#speak"><code class=property>speak</code></a>’
- property has the value ‘<code class=property>none</code>’. The
- former takes up the same time as if it had been spoken, including any
- pause before and after the element, but no sound is generated (although
- descendants can override the ‘<a href="#voice-volume"><code
- class=property>voice-volume</code></a>’ value and may therefore
- generate audio output). The latter requires no time and is not rendered in
- the aural dimension
+ ‘<code class=property>silent</code>’ (or "0 linear"), and an
+ element whose ‘<a href="#speak"><code
+ class=property>speak</code></a>’ property has the value ‘<code
+ class=property>none</code>’. The former takes up the same time as if
+ it had been spoken, including any pause before and after the element, but
+ no sound is generated (although descendants can override the ‘<a
+ href="#voice-volume"><code class=property>voice-volume</code></a>’
+ value and may therefore generate audio output). The latter requires no
+ time and is not rendered in the aural dimension
<!-- (including its descendants, which cannot override the inherited 'none' value). -->
(although descendants can override the ‘<a href="#speak"><code
class=property>speak</code></a>’ value and may therefore generate
@@ -1498,7 +1499,7 @@
<!-- td><uri> [<non-negative number> | <percentage> | silent
| x-soft | soft | medium | loud | x-loud] | none | inherit</td -->
- <td><uri> [<percentage> | silent] | none | inherit
+ <td><uri> [<percentage> | silent]? | none | inherit
<tr>
<td> <em>Initial:</em>
@@ -1546,7 +1547,7 @@
<!-- td><uri> [<non-negative number> | <percentage> | silent
| x-soft | soft | medium | loud | x-loud] | none | inherit</td -->
- <td><uri> [<percentage> | silent] | none | inherit
+ <td><uri> [<percentage> | silent]? | none | inherit
<tr>
<td> <em>Initial:</em>
@@ -1623,26 +1624,23 @@
inherited value of the ‘<a href="#voice-volume"><code
class=property>voice-volume</code></a>’ property is ‘<code
class=property>silent</code>’, this percentage value has no effect
- and the volume level for the audio cue is automatically resolved to
- ‘<code class=property>silent</code>’. Otherwise, computed
- values are calculated relative to the inherited value of the ‘<a
+ and the volume level for the audio cue is resolved to ‘<code
+ class=property>silent</code>’. Otherwise, computed values are
+ calculated relative to the inherited value of the ‘<a
href="#voice-volume"><code class=property>voice-volume</code></a>’
property, and are then clipped to the range ‘<code
class=css>0</code>’ to ‘<code class=css>100</code>’.
Refer to the ‘<a href="#voice-volume"><code
class=property>voice-volume</code></a>’ property for the meaning of
- the numerical scale between ‘<code class=css>0</code>’ and
- ‘<code class=css>100</code>’ (‘<code
- class=css>0</code>’ is not equivalent to ‘<code
- class=property>silent</code>’).
+ the numerical scale from ‘<code class=css>0</code>’ to
+ ‘<code class=css>100</code>’.
<p class=note> Note that a leading "+" sign does not denote an increment.
For example, +50% is equivalent to 50%, so the computed value equals the
inherited value times 0.5 (divided by 2), then clipped to [0,100].</p>
<dt> <strong>silent</strong>
- <dd>No sound output at all (note that this is not equivalent to the value
- ‘<code class=css>0</code>’).</dd>
+ <dd>No sound output.</dd>
<!-- dt><strong>silent</strong>,
<strong>x-soft</strong>,
<strong>soft</strong>,
@@ -2937,7 +2935,7 @@
<tr valign=baseline>
<td><a class=property href="#cue-after">cue-after</a>
- <td><uri> [<percentage> | silent] | none | inherit
+ <td><uri> [<percentage> | silent]? | none | inherit
<td>none
@@ -2952,7 +2950,7 @@
<tr valign=baseline>
<td><a class=property href="#cue-before">cue-before</a>
- <td><uri> [<percentage> | silent] | none | inherit
+ <td><uri> [<percentage> | silent]? | none | inherit
<td>none
@@ -3205,10 +3203,10 @@
<tr valign=baseline>
<td><a class=property href="#voice-volume">voice-volume</a>
- <td><non-negative number> | <percentage> | silent | x-soft |
- soft | medium | loud | x-loud | inherit
+ <td>[<non-negative number> linear?] | <percentage> | silent
+ | x-soft | soft | medium | loud | x-loud | inherit
- <td>medium
+ <td>50
<td>all elements
Index: Overview.src.html
===================================================================
RCS file: /sources/public/csswg/css3-speech/Overview.src.html,v
retrieving revision 1.48
retrieving revision 1.49
diff -u -d -r1.48 -r1.49
--- Overview.src.html 11 May 2011 00:44:39 -0000 1.48
+++ Overview.src.html 11 May 2011 01:27:14 -0000 1.49
@@ -272,14 +272,14 @@
<td>
<em>Value:</em>
</td>
- <td><non-negative number> | <percentage> | silent | x-soft | soft | medium |
- loud | x-loud | inherit</td>
+ <td>[<non-negative number> linear?] | <percentage> | silent | x-soft | soft |
+ medium | loud | x-loud | inherit</td>
</tr>
<tr>
<td>
<em>Initial:</em>
</td>
- <td>medium</td>
+ <td>50</td>
</tr>
<tr>
<td>
@@ -321,22 +321,25 @@
the <code>prosody</code> element</a> from the SSML markup language [[!SPEECH-SYNTHESIS]]. </p>
<dl>
<dt>
- <strong><non-negative number></strong>
+ <strong><non-negative number> (followed by the optional "linear" keyword)</strong>
</dt>
<dd>An integer or floating point <a href="#non-negative-number-def">positive number</a> in the
- range '0' to '100'. '0' represents the <em>minimum audible</em> level, and '100' corresponds
- to the <em>maximum tolerable</em> level. '50' corresponds to the user's preferred volume
- level. The numerical values exposed here are mapped to concrete volume levels that depend on
- the listening context. This allows authors to write a single style sheet that'll work in a
- variety of situations. <p class="note">Note that actual volume levels depend on various
+ range '0' to '100', followed by the optional space character and "linear" keyword. The
+ interpretation of the '0' to '100' scale depends on whether the "linear" keyword is used.
+ When not used: '0' represents the <em>minimum audible</em> level and '100' corresponds to
+ the <em>maximum tolerable</em> level. '50' corresponds to the user's <em>preferred</em>
+ volume level. As such, the numerical values are mapped to concrete volume levels that depend
+ on the listening context. This allows authors to write a single style sheet that should work
+ in a variety of situations. <p class="note">Note that actual volume levels depend on various
factors, such as the listening environment and personal user preferences. The effective
volume variation between '0' and '100' determines the dynamic range of the speech output,
which is typically compressed in a noisy environment (the volume corresponding to '0' is
nearer the value of '100'), whereas a noise-free context allows for the full range of
volume levels (the gap between '0' and '100' is wider). Conversely, there may be
situations whereby both '0' and '100' are set to low volume levels (for example when
- listening discretely at night). </p>
- </dd>
+ listening discretely at night). </p> When the "linear" keyword is specified, '0' maps to
+ 'silent' and '100' maps to the maximum possible audio volume output. The values in between
+ are placed on a linear amplitude scale. </dd>
<dt>
<strong><percentage></strong>
</dt>
@@ -349,22 +352,19 @@
<dt>
<strong>silent</strong>
</dt>
- <dd>No sound output at all (note that this is not equivalent to the value '0').</dd>
+ <dd>No sound output.</dd>
<dt><strong>x-soft</strong>, <strong>soft</strong>, <strong>medium</strong>,
<strong>loud</strong>, and <strong>x-loud</strong></dt>
- <dd>The value of 'x-soft' is mapped to '0' (<em>minimum audible</em>) and 'x-loud' is mapped
- to '100' (<em>maximum tolerable</em>). The value 'medium' corresponds to '50'
- (<em>preferred</em> volume level) and is the default. The intermediary values 'soft' and
- 'loud' are mapped to '25' and '75', respectively. Because the numerical volume scale may or
- may not be linear amplitude, this sequence of "named" values increases from 'x-soft' to
- 'x-loud', but does not necessarily map to monotonically non-decreasing volume levels. </dd>
+ <dd>The value 'x-soft' maps to 0, 'soft' maps to 25, 'medium' maps to 50, 'loud' maps to 75
+ and 'x-loud' maps to 100. When the numerical volume scale is linear, the sequence from
+ 'x-soft' to 'x-loud' corresponds to monotonically non-decreasing volume levels. </dd>
</dl>
<p class="note"> Note that there is a difference between an element whose 'voice-volume'
- property has a value of 'silent', and an element whose 'speak' property has the value 'none'.
- The former takes up the same time as if it had been spoken, including any pause before and
- after the element, but no sound is generated (although descendants can override the
- 'voice-volume' value and may therefore generate audio output). The latter requires no time and
- is not rendered in the aural dimension
+ property has a value of 'silent' (or "0 linear"), and an element whose 'speak' property has
+ the value 'none'. The former takes up the same time as if it had been spoken, including any
+ pause before and after the element, but no sound is generated (although descendants can
+ override the 'voice-volume' value and may therefore generate audio output). The latter
+ requires no time and is not rendered in the aural dimension
<!-- (including its descendants, which cannot override the inherited 'none' value). -->
(although descendants can override the 'speak' value and may therefore generate audio output). </p>
<!-- p>
@@ -1106,7 +1106,7 @@
</td>
<!-- td><uri> [<non-negative number> | <percentage> | silent
| x-soft | soft | medium | loud | x-loud] | none | inherit</td -->
- <td><uri> [<percentage> | silent] | none | inherit</td>
+ <td><uri> [<percentage> | silent]? | none | inherit</td>
</tr>
<tr>
<td>
@@ -1161,7 +1161,7 @@
</td>
<!-- td><uri> [<non-negative number> | <percentage> | silent
| x-soft | soft | medium | loud | x-loud] | none | inherit</td -->
- <td><uri> [<percentage> | silent] | none | inherit</td>
+ <td><uri> [<percentage> | silent]? | none | inherit</td>
</tr>
<tr>
<td>
@@ -1233,17 +1233,17 @@
synthetic speech. The default value is '100%'. Only positive <a href="#percentage-def"
>percentage</a> values are allowed. If the inherited value of the 'voice-volume' property
is 'silent', this percentage value has no effect and the volume level for the audio cue is
- automatically resolved to 'silent'. Otherwise, computed values are calculated relative to
- the inherited value of the 'voice-volume' property, and are then clipped to the range '0' to
- '100'. Refer to the 'voice-volume' property for the meaning of the numerical scale between
- '0' and '100' ('0' is not equivalent to 'silent'). <p class="note"> Note that a leading "+"
- sign does not denote an increment. For example, +50% is equivalent to 50%, so the computed
- value equals the inherited value times 0.5 (divided by 2), then clipped to [0,100]. </p>
+ resolved to 'silent'. Otherwise, computed values are calculated relative to the inherited
+ value of the 'voice-volume' property, and are then clipped to the range '0' to '100'. Refer
+ to the 'voice-volume' property for the meaning of the numerical scale from '0' to '100'. <p
+ class="note"> Note that a leading "+" sign does not denote an increment. For example, +50%
+ is equivalent to 50%, so the computed value equals the inherited value times 0.5 (divided
+ by 2), then clipped to [0,100]. </p>
</dd>
<dt>
<strong>silent</strong>
</dt>
- <dd>No sound output at all (note that this is not equivalent to the value '0').</dd>
+ <dd>No sound output.</dd>
<!-- dt><strong>silent</strong>,
<strong>x-soft</strong>,
<strong>soft</strong>,
Received on Wednesday, 11 May 2011 01:27:18 UTC