- From: Daniel Weck via cvs-syncmail <cvsmail@w3.org>
- Date: Wed, 11 May 2011 00:19:09 +0000
- To: public-css-commits@w3.org
Update of /sources/public/csswg/css3-speech
In directory hutz:/tmp/cvs-serv20137
Modified Files:
Overview.html Overview.src.html
Log Message:
fixed volume-related issues
Index: Overview.html
===================================================================
RCS file: /sources/public/csswg/css3-speech/Overview.html,v
retrieving revision 1.45
retrieving revision 1.46
diff -u -d -r1.45 -r1.46
--- Overview.html 10 May 2011 23:05:19 -0000 1.45
+++ Overview.html 11 May 2011 00:19:07 -0000 1.46
@@ -591,9 +591,27 @@
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 silence (the <em>minimum</em> level), and ‘<code
- class=css>100</code>’ corresponds to the <em>maximum</em> level.
- The volume scale is linear amplitude.
+ 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.
+ <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
+ class=css>0</code>’ and ‘<code class=css>100</code>’
+ determines the dynamic range of the speech output, which is typically
+ compressed in a noisy environment (the volume corresponding to
+ ‘<code class=css>0</code>’ is nearer the value of
+ ‘<code class=css>100</code>’), whereas a noise-free context
+ allows for the full range of volume levels (the gap between ‘<code
+ class=css>0</code>’ and ‘<code class=css>100</code>’
+ is wider). Conversely, there may be situations whereby both ‘<code
+ class=css>0</code>’ and ‘<code class=css>100</code>’
+ are set to low volume levels (for example when listening discretely at
+ night).</p>
<dt> <strong><percentage></strong>
@@ -605,24 +623,32 @@
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>, <strong>x-soft</strong>,
- <strong>soft</strong>, <strong>medium</strong>, <strong>loud</strong>,
- and <strong>x-loud</strong>
+ <dt> <strong>silent</strong>
- <dd>A sequence of monotonically non-decreasing volume levels. The value of
- ‘<code class=property>silent</code>’ is mapped to
- ‘<code class=css>0</code>’ and ‘<code
- class=property>x-loud</code>’ is mapped to ‘<code
- class=css>100</code>’. The mapping of other values to numerical
- volume levels is implementation-dependent and may vary from one speech
- synthesizer to another.
- </dl>
+ <dd>No sound output at all (note that this is not equivalent to the value
+ ‘<code class=css>0</code>’).
- <p>User agents should allow the level corresponding to ‘<code
- class=css>100</code>’ to be set by the listener. No one setting is
- universally applicable; suitable values depend on the equipment in use
- (speakers, headphones), and the environment (in car, home theater,
- library) and personal preferences.
+ <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
+ class=property>x-soft</code>’ to ‘<code
+ class=property>x-loud</code>’, but does not necessarily map 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
@@ -1481,7 +1507,7 @@
<!-- td><uri> [<non-negative number> | <percentage> | silent
| x-soft | soft | medium | loud | x-loud] | none | inherit</td -->
- <td><uri> [<percentage>] | none | inherit
+ <td><uri> [<percentage> | silent] | none | inherit
<tr>
<td> <em>Initial:</em>
@@ -1533,7 +1559,7 @@
<!-- td><uri> [<non-negative number> | <percentage> | silent
| x-soft | soft | medium | loud | x-loud] | none | inherit</td -->
- <td><uri> [<percentage>] | none | inherit
+ <td><uri> [<percentage> | silent] | none | inherit
<tr>
<td> <em>Initial:</em>
@@ -1600,23 +1626,33 @@
<dt> <strong><percentage></strong>
- <dd> Only positive <a href="#percentage-def">percentage</a> values are
- allowed. 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>’. ‘<code
- class=css>0</code>’ represents silence (the <em>minimum</em>
- level), and 100 corresponds to the <em>maximum</em> level. The volume
- scale is linear amplitude. By basing the percentage upon the inherited
- value for ‘<a href="#voice-volume"><code
- class=property>voice-volume</code></a>’, it is easy to adjust the
- loudness of cues relatively to the synthetic speech of the target element
- content.
+ <dd> The loudness of prerecorded audio cues can be adjusted relatively to
+ the volume level of synthetic speech. The default value is ‘<code
+ class=css>100%</code>’. Only positive <a
+ href="#percentage-def">percentage</a> values are allowed. If the
+ 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
+ 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>’).
<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>
+
+ <dd>No sound output at all (note that this is not equivalent to the value
+ ‘<code class=css>0</code>’).</dd>
<!-- dt><strong>silent</strong>,
<strong>x-soft</strong>,
<strong>soft</strong>,
@@ -2921,7 +2957,7 @@
<tr valign=baseline>
<td><a class=property href="#cue-after">cue-after</a>
- <td><uri> [<percentage>] | none | inherit
+ <td><uri> [<percentage> | silent] | none | inherit
<td>none
@@ -2936,7 +2972,7 @@
<tr valign=baseline>
<td><a class=property href="#cue-before">cue-before</a>
- <td><uri> [<percentage>] | none | inherit
+ <td><uri> [<percentage> | silent] | none | inherit
<td>none
@@ -3617,6 +3653,9 @@
consistent with other CSS specifications (i.e. "see individual
properties"), and removed the erroneous "inherit" value.
+ <li>Fixed numerical volume scale (and the associated "named" values). Also
+ added the [silent] value to audio cues.
+
<li>Fixed the [initial] values for ‘<a href="#pause"><code
class=property>pause</code></a>’ and ‘<a href="#rest"><code
class=property>rest</code></a>’, which should be zero (were
Index: Overview.src.html
===================================================================
RCS file: /sources/public/csswg/css3-speech/Overview.src.html,v
retrieving revision 1.46
retrieving revision 1.47
diff -u -d -r1.46 -r1.47
--- Overview.src.html 10 May 2011 23:05:19 -0000 1.46
+++ Overview.src.html 11 May 2011 00:19:07 -0000 1.47
@@ -315,8 +315,7 @@
</table>
<p>The 'voice-volume' property manipulates the amplitude of the audio waveform generated by the
speech synthesiser, and is also used to calculate the relative volume level of <a
- href="#cue-props">audio cues</a> within the <a href="#aural-model">audio "box"
- model</a>.</p>
+ href="#cue-props">audio cues</a> within the <a href="#aural-model">audio "box" model</a>. </p>
<p class="note"> Note that the functionality provided by this property is related to the <a
href="http://www.w3.org/TR/speech-synthesis/#edef_prosody"><code>volume</code> attribute of
the <code>prosody</code> element</a> from the SSML markup language [[!SPEECH-SYNTHESIS]]. </p>
@@ -325,8 +324,19 @@
<strong><non-negative number></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 silence (the <em>minimum</em> level), and '100'
- corresponds to the <em>maximum</em> level. The volume scale is linear amplitude. </dd>
+ 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
+ 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>
<dt>
<strong><percentage></strong>
</dt>
@@ -336,15 +346,19 @@
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>, <strong>x-soft</strong>, <strong>soft</strong>,
- <strong>medium</strong>, <strong>loud</strong>, and <strong>x-loud</strong></dt>
- <dd>A sequence of monotonically non-decreasing volume levels. The value of 'silent' is mapped
- to '0' and 'x-loud' is mapped to '100'. The mapping of other values to numerical volume
- levels is implementation-dependent and may vary from one speech synthesizer to another.</dd>
+ <dt>
+ <strong>silent</strong>
+ </dt>
+ <dd>No sound output at all (note that this is not equivalent to the value '0').</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>
</dl>
- <p>User agents should allow the level corresponding to '100' to be set by the listener. No one
- setting is universally applicable; suitable values depend on the equipment in use (speakers,
- headphones), and the environment (in car, home theater, library) and personal preferences.</p>
<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
@@ -1093,7 +1107,7 @@
</td>
<!-- td><uri> [<non-negative number> | <percentage> | silent
| x-soft | soft | medium | loud | x-loud] | none | inherit</td -->
- <td><uri> [<percentage>] | none | inherit</td>
+ <td><uri> [<percentage> | silent] | none | inherit</td>
</tr>
<tr>
<td>
@@ -1149,7 +1163,7 @@
</td>
<!-- td><uri> [<non-negative number> | <percentage> | silent
| x-soft | soft | medium | loud | x-loud] | none | inherit</td -->
- <td><uri> [<percentage>] | none | inherit</td>
+ <td><uri> [<percentage> | silent] | none | inherit</td>
</tr>
<tr>
<td>
@@ -1215,16 +1229,21 @@
<dt>
<strong><percentage></strong>
</dt>
- <dd> Only positive <a href="#percentage-def">percentage</a> values are allowed. Computed
- values are calculated relative to the inherited value of the 'voice-volume' property, and
- are then clipped to the range '0' to '100'. '0' represents silence (the <em>minimum</em>
- level), and 100 corresponds to the <em>maximum</em> level. The volume scale is linear
- amplitude. By basing the percentage upon the inherited value for 'voice-volume', it is easy
- to adjust the loudness of cues relatively to the synthetic speech of the target element
- content. <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> The loudness of prerecorded audio cues can be adjusted relatively to the volume level of
+ 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>
</dd>
+ <dt>
+ <strong>silent</strong>
+ </dt>
+ <dd>No sound output at all (note that this is not equivalent to the value '0').</dd>
<!-- dt><strong>silent</strong>,
<strong>x-soft</strong>,
<strong>soft</strong>,
@@ -2624,6 +2643,8 @@
<li>Adjusted the [initial] value for shorthand properties, to be consistent with other CSS
specifications (i.e. "see individual properties"), and removed the erroneous "inherit"
value.</li>
+ <li>Fixed numerical volume scale (and the associated "named" values). Also added the [silent]
+ value to audio cues.</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>
Received on Wednesday, 11 May 2011 00:19:11 UTC